backup-restore

Fresh

Source: BIBLE.md (Phase 12 Phase 3, backup-restore 4 routes, tested 106 files / 193 KB)

Recursive data directory backup and restore. Tested at 106 files, 193 KB.

Routes (4)

Method	Route	What
POST	/backup/create	Create a backup archive
GET	/backup/list	List backups
POST	/backup/restore	Restore from archive
DELETE	/backup/:id	Delete an archive

Example: create backup

curl -X POST http://localhost:4700/backup/create \
  -H "Content-Type: application/json" \
  -d '{ "label": "pre-upgrade-2026-05-20" }'

Archives all data/ghost-engine/ and data/mini-engine*/ directories.

Example: restore

curl -X POST http://localhost:4700/backup/restore \
  -H "Content-Type: application/json" \
  -d '{ "backupId": "backup-abc123", "overwrite": false }'

Storage

Archives stored at data/ghost-engine/backups/{id}.tar.gz (or .zip on Windows). Metadata at {id}.json.

Related

• Error Recovery
• Data Stores reference