Docs / Platform Ops

Backups & restore

Default data directory: BREACHFIX_CLOUD_DATA_DIR → data/ under the repo.

Control plane SQLite

Databasedata/breachfix-cloud.sqlite
Build artifactsdata/builds/
GitHub App keyPath from GITHUB_APP_PRIVATE_KEY_PATH — never git

Backup example

sudo systemctl stop breachfix-cloud
cp -a data/breachfix-cloud.sqlite /backup/breachfix-cloud-$(date +%F).sqlite
./scripts/backup-data.sh   # SQLite + data/volumes/
sudo systemctl start breachfix-cloud

Postgres volumes

Managed Postgres data lives in Docker volumes under data/volumes/. Automated pg_dump is not scheduled — see Automated Postgres backups (planned).

Restore

  1. Restore breachfix-cloud.sqlite into BREACHFIX_CLOUD_DATA_DIR
  2. Verify .env public URL and API keys
  3. pnpm -r build && ./scripts/start.sh or restart systemd unit