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
8888
to12321
(the host port is the first number, so12321:8888
. I forget the order of these every single time) - update the password from
really-insecure
to a random string - change
restart: always
torestart: 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_address
and 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
https
instead 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 key
and store the output to your password manager
- edit
- Now you have a user on the server. For each client computer:
- update
sync_address
in 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