Running Infrahub in production means you’re managing the data that defines your infrastructure, including object relationships, schemas, version history, and automation state.
Protecting that data is essential yet until now most teams had to maintain custom scripts and manual procedures per component to back it up.
Infrahub Backup provides a unified, automated way to capture and restore your entire Infrahub environment using one consistent workflow.
Why we built Infrahub Backup
As Infrahub deployments scale, manual backup routines become difficult to sustain.
Each team handles it differently: exporting Neo4j manually, copying PostgreSQL volumes, or taking container snapshots. These approaches work but are hard to repeat, verify, or automate.
Infrahub Backup standardizes this process. It orchestrates a coordinated backup that pauses running tasks, safely takes a data snapshot, and packages the results into a single, verifiable archive.
During restore, it validates the backup, replays each step in dependency order, and restarts services automatically.
In short, it turns what used to be a manual, multi-step operation into a single command you can schedule, monitor, and trust.
How Infrahub Backup works
The tool runs as a lightweight command-line interface that detects your deployment environment, coordinates backups for all Infrahub services, and validates results on completion.
- Detects your environment (Docker Compose or Kubernetes via
kubectl) - Pauses running tasks to ensure data consistency
- Captures Neo4j and PostgreSQL databases in sync
- Packages everything into a validated, timestamped archive
- Restores data predictably, restarting services in dependency order
- Produces logs and checksums for auditing and verification
Full Docker Compose support is available now. Kubernetes deployments can be backed up and restored using kubectl, with future releases planned to add full in-cluster (“in-band”) support for Kubernetes environments.
Best practices for production use
Automate backups
Schedule recurring backups through cron or CI workflows. Daily snapshots are a solid baseline, with shorter intervals for dynamic or large environments. Use retention policies and off-site replication to meet your recovery objectives.
Test restores regularly
Run restore drills in a staging environment to verify access, timing, and completeness. Document results so your team knows exactly what to expect in a real recovery scenario.
Validate after upgrades
Capture a new backup after any Infrahub version upgrade and perform a test restore. Schema changes or new services may introduce additional dependencies that must be included in future backups.
Why Infrahub Backup matters
Infrahub holds the authoritative data that drives automation: your topology, intent, configurations, and lineage.
If that data is lost or inconsistent, automation stops. Reliable backups are the only safeguard against data corruption, failed upgrades, or accidental deletions.
Infrahub Backup provides a repeatable, auditable process for protecting Infrahub’s data that fits directly into existing operational workflows. You can now schedule, test, and validate backups with the same level of rigor you apply to your infrastructure code.
When to use Infrahub Backup
- Production environments: Run recurring automated backups as part of standard operations.
- Pre-upgrade checkpoints: Capture a snapshot before major Infrahub version changes.
- Disaster recovery testing: Perform restores in non-production to verify recovery time.
- Environment replication: Restore snapshots to staging for troubleshooting or development.
Looking ahead
Infrahub Backup joins Infrahub Sync and other operational utilities that make it easier to run Infrahub reliably at scale.
Future releases will expand native Kubernetes support and provide deeper integration with existing scheduling and monitoring systems.
For teams managing critical automation data, this tool closes a major operational gap and ensures that Infrahub can always be recovered, verified, and trusted.
- Read more: Infrahub Backup documentation
- Download now: Infrahub Backup on GitHub
