Skip to main content

Backup & Restore

Backup/restore control-plane logic is implemented in the controller service and exposed through CLI/gRPC paths.

Code Anchors​

  • Controller backup manager: services/controller/internal/grpc/backup_manager.go
  • Restore manager: services/controller/internal/restore/restore.go
  • CLI client and commands: tools/cli/internal/client/controller.go, tools/cli/internal/commands/restore.go

Operational Model​

  • Create/list/get/verify/delete backup metadata
  • Restore workflows (including dry-run and status tracking)
  • Backup scheduling APIs in controller backup service

Compose Defaults​

docker-compose.yml includes CONTROLLER_BACKUP_CRON and object-store credentials for local development workflows.

Recommendation​

Run backup/restore drills in staging and validate:

  • Data correctness after restore
  • Index/state restoration
  • Recovery-time objectives for your dataset size