self-hosting atuin
last updated: Jan 10, 2024
The atuin docs for self-hosting are very skimpy
Here's how I self-hosted an atuin server:
- Make
~/srv/atuin - Copy the docker-compose.yml file from here to
~/srv/atuin/docker-compose.yml - Changes I made to that file:
- change the host port from
8888to12321(the host port is the first number, so12321:8888. I forget the order of these every single time) - update the password from
really-insecureto a random string - change
restart: alwaystorestart: unless-stopped; this is the same except it allows you to stop it, which is probably what you want
- change the host port from
- start the server:
docker compose up -d - Now you should have a running server! The next step is to create an account. From one client computer:
- edit
~/.config/atuin/config.toml(that's where it lives on my system anyway, find your config file). Uncommentsync_addressand change it tohttp://<your-host>:12321- I did not bother to enable TLS on my server because I'm not going to expose it outside of my home network; if you do, use
httpsinstead ofhttp
- I did not bother to enable TLS on my server because I'm not going to expose it outside of my home network; if you do, use
- run
atuin account register- follow the prompts to create a user, and save your password to your password manager
- run
atuin keyand store the output to your password manager
- edit
- Now you have a user on the server. For each client computer:
- update
sync_addressin your config file - run
atuin login- Make sure you give it the encryption key you got from
atuin key
- Make sure you give it the encryption key you got from
- run
atuin sync
- update