Datab
On-node operator commands

CLI Tools

Every Datab Node ships a small CLI surface under /snap/datab-app/current/scripts/. These are the canonical operator commands; the operator console (datab-os-mobile) is the GUI wrapper.

Always-safe diagnostics

  • doctor.sh — 19-check runtime diagnostic. Exit 0 means no critical failures. Suitable for pasting into a support thread.
  • health-check.sh — quick health snapshot (delegated to the backend /api/health/full).

Bootstrap + recovery

  • ensure-postgres-role.sh — idempotent role + database creation. Runs from run-migrations.sh before Flyway. Safe to re-run by hand to reconcile after a credential rotation.
  • restore-postgres.sh — restore from a backup dump.
  • backup-postgres.sh — manual backup trigger (the nightly cron uses the same script).
  • retention.sh — apply backup retention policy.

Service runners (snapd-supervised)

  • run-postgres.sh, run-dockerd.sh, run-containerd.sh
  • run-micronaut-backend.sh, run-atlas-core.sh, run-ollama.sh
  • run-orula.sh, run-gu.sh, run-restore-watcher.sh
  • run-migrations.sh (oneshot), run-compositor.sh (optional kiosk)

Operator Docker

The snap uses a snap-local Docker socket. To run docker commands from a plain shell:

export DOCKER_HOST=unix:///var/snap/datab-app/common/run/docker.sock
/snap/datab-app/current/usr/bin/docker -H "$DOCKER_HOST" ps