Running a live Datab Node day to day
Operator Docs
Operator-facing reference for institution administrators. The full operator boot guide lives in the repository at docs/release/RC1_OPERATOR_BOOT_GUIDE.md; this page is the quick reference.
Twelve-step daily-ops checklist
- Install the snap (or boot the node image).
- Start services in dependency order — snapd handles this automatically.
- Export
DOCKER_HOST=unix:///var/snap/datab-app/common/run/docker.sockif running docker from a plain shell. - Run
ensure-postgres-role.shafter any credential rotation. - Health-curl every service: backend 8080, Atlas 8090, Orula 11444, Gu 11445.
- Tail JSONL audit + reward logs at
/var/snap/datab-app/common/{orula,gu}/{audit,reward}.jsonl. - Use the operator console (
datab-os-mobile) for daily monitoring. - Service logs:
snap logs datab-app.<service>. - Run
doctor.shwhen anything looks off. - Set
DATAB_INTERNAL_API_KEYon first deploy. Rotate per institutional policy. - Rollback procedure:
snap revert datab-app+ restore-watcher for DB. - File issues via
hello@databsystems.comwith the doctor.sh output attached.
Disruptive actions — confirm before running
- Reboot via
/api/system/reboot. Operator console confirms before triggering. - Shutdown via
/api/system/shutdown. Same. - Backup trigger via
/api/backup/trigger. Idempotent; safe to retry. - Restore: import or select an authenticated
.pgdump.encartifact in the admin Backup & Restore surface, prepare the restore, then confirmRESTORE. The restore-watcher consumes the emittedrestore.requestfile.
What operators should NOT do
- Run
dockeragainst the host socket — the snap uses its own socket. - Edit Postgres data directly. Use the API.
- Disable
datab-app.flyway. Migrations are how the schema stays consistent across upgrades. - Run
snap revertwithout checking the changelog. See Changelogs first.