btrfs-backup-ng-run - Man Page

btrfs-backup-ng run [Options]

Execute all configured backup jobs. This command performs three operations in sequence for each configured volume:

1. Create a new snapshot of the source volume
2. Transfer snapshots to all configured targets (incrementally when possible)
3. Apply retention policies to clean up old snapshots and backups

This is the primary command for automated backups via systemd timers or cron.

--dry-run

Show what would be done without making any changes. Useful for testing configuration and verifying behavior.

--parallel-volumes N

Maximum number of volumes to process concurrently. Overrides the parallel_volumes setting in the configuration file.

--parallel-targets N

Maximum number of targets to transfer to concurrently per volume. Overrides the parallel_targets setting in the configuration file.

--compress METHOD

Compression method for transfers. Overrides per-target configuration. Valid methods: none, zstd, gzip, lz4, pigz, lzop.

--rate-limit RATE

Bandwidth limit for transfers. Overrides per-target configuration. Examples: 10M (10 MB/s), 1G (1 GB/s), 500K (500 KB/s).

--progress

Show progress bars during transfers. Default when running in a terminal.

--no-progress

Disable progress bars. Default when not running in a terminal (e.g., cron).

Run all backup jobs:

btrfs-backup-ng run

Dry run to see what would happen:

btrfs-backup-ng run --dry-run

Run with parallel processing:

btrfs-backup-ng run --parallel-volumes 2 --parallel-targets 3

Run with compression and rate limiting:

btrfs-backup-ng run --compress zstd --rate-limit 50M

btrfs-backup-ng(1), btrfs-backup-ng-snapshot(1), btrfs-backup-ng-transfer(1), btrfs-backup-ng-prune(1)

btrfs-backup-ng(1), btrfs-backup-ng-estimate(1), btrfs-backup-ng-prune(1), btrfs-backup-ng-snapshot(1), btrfs-backup-ng-transfer(1).