Backup and restore

Back up 3AM's data volume, and restore it on the same server or a new one.

Everything 3AM keeps is in one volume: 3am-data on a server, or the data-threeam-0 volume on Kubernetes. It holds the audit log, incidents, connections, settings, secrets, people and the admin token. Back it up and you've backed up 3AM.

On a server, also keep ~/.3am/: the installer's settings and copies of your key files.

Backups contain secrets

The volume holds the credentials 3AM uses for your tools. Store backups the way you store passwords.

Back up

podman stop 3am-core
podman volume export 3am-data -o 3am-data-$(date +%F).tar
podman start 3am-core

Stopping 3AM for the copy keeps it consistent. It picks up where it left off.

Restore

./install.sh --uninstall                         # skip this on a fresh server
podman volume rm 3am-data
podman volume create 3am-data
podman volume import 3am-data 3am-data-2026-10-04.tar
./install.sh --yes

Then check that the audit log came back intact:

podman exec 3am-core /opt/3am/3am-core ledger-verify /var/lib/3am/ledger

Common questions

On this page