nfrastack/db-backup

Consistent, scheduled database backups for nine engines with a single, secret friendly binary.

db-backup is a cross platform tool that backs up, restores, verifies, and maintains databases across multiple engines using one unified configuration syntax. Whether you are calling it from your own scripts or using the built-in multi-job scheduler, db-backup fits servers, containers, and CI pipelines alike.

Features

• Multi engine - MySQL, MariaDB, PostgreSQL, MongoDB, Microsoft SQL Server, Redis, SQLite3, InfluxDB, CouchDB
• Backup strategies - full, incremental, differential, schema only
• Table selection - include/exclude filters, per table schema only
• Storage - filesystem, S3 compatible, WebDAV, Azure Blob, Google Cloud Storage
• Encryption at rest - AGE, GPG/OpenPGP, OpenSSL AES-256 recipients or passphrases
• Scheduling - cron, intervals, clock times, natural language, day filters, blackout windows
• Retention - keep last, time window, and per period tiers (hourly/daily/weekly/monthly/yearly)
• Compression - zstd, gzip, bzip2, xz with configurable levels and parallel threading
• Restore - CLI, interactive guided mode, config driven profiles
• Integrity - checksums, JSON sidecar metadata per backup
• Maintenance analyze, optimize, vacuum, reindex, compact, memory purge on succesful backup or independently.
• Hooks & observability - pre/post hooks, live progress, detailed logging via text or json

Most features work out of the box in the free Community edition. Some advanced features require a Supporter license.

Get Started

Run your first backup with the container:

docker run --rm \
  -e DB01_TYPE=mysql \
  -e DB01_HOST=db-internal \
  -e DB01_USER=backup \
  -e DB01_PASS=secret \
  -e DB01_NAME=testdb \
  -v ./backups:/backup \
  docker.io/nfrastack/db-backup:latest

Or grab a precompiled binary, build from source, or use the NixOS module and use the configuration files to perform advanced functions.

Documentation

All documentation lives at nfrastack.com/db-backup:

Editions

db-backup uses an open-core model. The Community Edition is free and open source under AGPL-3.0-or-later. Upgrading to a Supporter Edition is licensed under a proprietary commercial license and unlocks advanced features while directly funding ongoing development. See the full edition comparison.

Support

If you found a bug, please submit a Bug Report. Usage questions will be closed as not-a-bug.

For implementation help, consulting, or Supported edition licenses, reach out at hello@nfrastack.com or visit nfrastack.com/db-backup/support.

License

This project is dual licensed:

• The GNU Affero General Public License v3.0 or later is a free software license covering the Community Edition ensuring your freedom to use, modify, and distribute the software with the condition that modified versions are distributed under the same license.
• The proprietary Nfrastack Supporter License v1 (NSLv1) governs the Supported Edition (supported/), unlocking advanced capabilities along with license compliance and direct support.

Each file in this project carries an SPDX license identifier following the REUSE guidelines; the full texts of both licenses are available in the LICENSES directory.

The container image packaging (container/) is licensed separately under the MIT License - see container/LICENSE, the bundled dbb binary inside the image is licensed as described above, not under MIT.

Copyright

Copyright (C) 2026 Nfrastack