Docs / Platform Ops

Backups & restore

Default data directory: ISOWARD_DATA_DIR (legacy BREACHFIX_CLOUD_DATA_DIR) → data/ under the repo.

Control plane SQLite

Databasedata/isoward.sqlite (legacy breachfix-cloud.sqlite renamed on first boot)
Build artifactsdata/builds/
Gateway logdata/isoward.log
GitHub App keyPath from GITHUB_APP_PRIVATE_KEY_PATH: never git

Backup example

bash
docker compose stop isoward-gateway
cp -a data/isoward.sqlite /backup/isoward-$(date +%F).sqlite
./scripts/backup-data.sh   # SQLite + data/volumes/
docker compose start isoward-gateway

Postgres volumes

Managed Postgres data lives in Docker volumes under data/volumes/. Scheduled pg_dump backups are written to data/backups/postgres/: see Automated Postgres backups.

Restore

  1. Restore isoward.sqlite into ISOWARD_DATA_DIR
  2. Verify .env public URL and API keys
  3. pnpm -r build && ./scripts/start.sh or docker compose up -d --build