Help Center/Admin Operations/How to run a backup so it appears in Backup Status
Admin Operations•Last updated: 2026-10-20•3 min read

How to run a backup so it appears in Backup Status

Backups are made by two scripts that both record their run in i8_database_backups; the Resilience screens read that ledger.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Off-box backup

Run npm run backup:db. It dumps the database to Supabase storage, writes a "running" row at the start and closes it as succeeded or failed. Run npm run backup:db:verify afterwards to re-read the archive and stamp it VERIFIED.

2

Local backup

Run node scripts/backup-local.mjs [--label=name] to write a file under ./backups. It records a row with Stored "local disk"; that row is not an off-box backup.

3

Check the screen

Open Resilience > Backup Status and Refresh. "Off-box freshness" turns FRESH after a successful off-box run and STALE after 26 hours.

Expected Operational Outcome

The run is listed with its status, size, duration and verification state.

Troubleshooting & Failure Modes

Symptom: The screen says the backup ledger could not be read
Likely Cause: i8_database_backups does not exist.
Resolution: Run node scripts/apply-email-backup-schema.mjs.

Was this guide helpful?

Help us refine our platform documentation