Backup & restore
Protect and recover your control-plane state with encrypted, timestamped backups.
Backups are enterprise self-hosted table stakes. The control plane's state — its database, environment and load-balancer config — is small and quick to back up.
What to back up
The database, the environment file, and the load-balancer config. The release webroot (browser builds, profile bundles) is large but reproducible from the release pipeline, so back it up optionally.
Backup
The backup command produces a single timestamped, optionally-encrypted archive.
veil-cm backupCommon options (environment variables):
Prop
Type
For routine snapshots there is a fast, no-downtime database-only path.
Roadmap
The veil-cm command suite and turnkey backup/restore scripts are part of the
self-hosted distribution roadmap. Until they ship, use the database backup one-liner
documented for your install and archive the env + load-balancer config alongside it.
Restore
Restore reverses the process and halts on any error:
Stop the service
Restoring over a running instance is refused without an explicit force flag.
Extract and restore
Decrypt (if needed), restore the database, environment and config.
Migrate and verify
Run database migrations and confirm the health check passes before taking traffic.
veil-cm restore ./cluster-manager-backup-2026-07-18.tar.gz