Deploy Atuin
Self-hosted Atuin shell history sync server with Postgres
Just deployed
Just deployed
/var/lib/postgresql/data
Deploy and Host Atuin on Railway
Atuin replaces your shell history (bash, zsh, fish, nushell) with a searchable database that also records the directory, exit code and duration of each command. It syncs that history between your machines, encrypted on each machine before upload. This template runs your own Atuin sync server, version 18.24.8.
About Hosting Atuin
The template deploys two services. Atuin is the sync server, built from a public GitHub repo on top of the official image (pinned by version and digest), with a public HTTPS domain and a /healthz health check. Postgres stores accounts and encrypted history on a volume, reachable only over the private network. Registration stays closed: on first boot the server creates one account, atuin, with a generated password you read in the Atuin service's Variables tab. After deploy, set sync_address in each client's config to your Railway domain, run atuin login, then atuin sync. Updates arrive as Railway update notices when the repo's version is bumped.
Common Use Cases
- Sync shell history across your laptop, desktop and servers
- Keep encrypted command history on infrastructure you control instead of a hosted service
- Search past commands by directory, host, exit code or time on any machine
Dependencies for Atuin Hosting
- Atuin sync server (
ghcr.io/atuinsh/atuin, MIT) - PostgreSQL (Railway Postgres)
Deployment Dependencies
- Atuin source and releases: https://github.com/atuinsh/atuin/releases
- Self-hosting docs: https://docs.atuin.sh/self-hosting/server-setup/
- Template repo (Dockerfile, start script, changelog): https://github.com/aalfath/atuin-railway-template
Implementation Details
On each machine, after installing the Atuin client:
# ~/.config/atuin/config.toml
sync_address = "https://YOUR-DOMAIN"
atuin login -u atuin # password: ADMIN_PASSWORD from the Atuin service's Variables tab
atuin import auto
atuin sync
On the first machine leave the encryption key prompt empty; on the others paste the output of atuin key. The server can't read or recover your history without that key. To let other people sign up, add ATUIN_OPEN_REGISTRATION=true; to add accounts by hand, run atuin-server admin user create NAME --email EMAIL in a shell on the Atuin service.
Why Deploy Atuin on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Atuin on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
