Backup & Recovery

Backup

BACKUP TENANT acme TO '/backups/acme-2026-04.bak';

Backups cover all 7 engines: documents, indexes, vectors, graph edges, KV tables, timeseries, and CRDT state. Encrypted with AES-256-GCM using the tenant WAL key.

Validate

RESTORE TENANT acme FROM '/backups/acme-2026-04.bak' DRY RUN;

Validates the backup without restoring.

Restore

RESTORE TENANT acme FROM '/backups/acme-2026-04.bak';

Crash Recovery

On startup, NodeDB:

1. Scans WAL segments from the last checkpoint
2. Validates CRC32C checksums
3. Replays valid records to reconstruct state
4. Discards partially written records

The Event Plane resumes from its LSN watermark — no events are lost.

WAL Archiving

WAL segments can be archived for point-in-time recovery. Old segments are eligible for cleanup once all records have been flushed to L1 segments.