Self-hosted sync server for Atuin shell history
Self-hosted sync server for Atuin, enabling encrypted shell history
synchronisation across multiple machines.
All server settings are configured via server.toml, written to
/var/snap/atuin-server/common/server.toml with documented defaults on
first install. Edit that file, then start the server.
QUICK START — SQLite (simplest, single-machine):
sudo snap install atuin-server
# The server starts automatically using the default SQLite db.
# Edit /var/snap/atuin-server/common/server.toml to customise.
QUICK START — bundled PostgreSQL 18 (multi-user / team):
sudo snap install atuin-server
sudo snap set atuin-server atuin-server.use-postgres=true
# Starts bundled postgres, restarts the server, injects the URI.
SNAP CONFIG:
atuin-server.use-postgres true|false Enable/disable bundled PostgreSQL
Bundled PostgreSQL port and password are set in:
/var/snap/atuin-server/common/postgres.conf
NOTE: external PostgreSQL must be reachable via TCP (localhost or a
hostname). Unix-socket connections are blocked by snap confinement.