backupd

Status: production ready for self-hosted use.

Declarative S3-compatible backup daemon. Define your backup plans in a single YAML file - sources, destination, encryption, retention, tags, and hooks - and let backupd handle the rest.

Full documentation: https://soroushalinia.github.io/backupd/

Changelog: CHANGELOG.md

curl -fsSL https://raw.githubusercontent.com/soroushalinia/backupd/main/install.sh | sh

See the installation guide.

• Declarative YAML config with ${ENV_VAR} interpolation
• S3-compatible storage (AWS S3, MinIO, DigitalOcean Spaces, Backblaze B2)
• Incremental backups via rsync-style delta algorithm
• Database backup: PostgreSQL, MySQL, MongoDB, SQLite (exec mode)
• Docker volume backup via docker run --rm
• Kubernetes PVC backup via kubectl exec
• AES-256-GCM encryption with Argon2id key derivation
• Retention policies: keep-last, daily, weekly, monthly
• Pre/post/on-failure command hooks
• Embedded cron scheduler and systemd timer/service export
• Snapshot integrity verification
• Shell completion for bash, zsh, fish

go install github.com/soroushalinia/backupd/cmd/backupd@latest

Or build from source:

git clone https://github.com/soroushalinia/backupd.git
cd backupd
make build

Create ~/.backupd.yaml:

plans:
  - name: server
    schedule: "0 3 * * *"
    sources:
      - type: file
        path: /etc
        exclude: ["*.log", ".cache"]
    destination:
      type: s3
      bucket: my-backups
      endpoint: s3.amazonaws.com
      region: us-east-1
      access-key: ${AWS_ACCESS_KEY_ID}
      secret-key: ${AWS_SECRET_ACCESS_KEY}
    retention:
      keep-last: 30
      keep-daily: 7
      keep-weekly: 4

backupd run server
backupd status
backupd history server
backupd restore server <snapshot-id> --target /tmp/restore

MIT