btrbk
Backup tool for btrfs snapshots and subvolumes
TLDR
Print statistics about subvolumes and snapshots
$ sudo btrbk stats
List configured subvolumes and snapshots$ sudo btrbk list
Print what would happen in a dry run$ sudo btrbk -v dryrun
Run backup routines with progress$ sudo btrbk --progress -v run
Only create snapshots for configured subvolumes$ sudo btrbk snapshot
SYNOPSIS
btrbk [options] command [filter]
DESCRIPTION
btrbk is a backup tool for btrfs filesystems that creates and manages snapshots and remote backups. It uses btrfs send/receive for efficient incremental backups and supports complex retention policies.
Configuration is defined in /etc/btrbk/btrbk.conf, specifying source subvolumes, snapshot locations, and backup targets including remote hosts via SSH.
PARAMETERS
-v, --verbose
Increase verbosity--progress
Show progress during transfers-n, --dry-run
Same as dryrun command-c file
Use alternate configuration file
CONFIGURATION
/etc/btrbk/btrbk.conf
Main configuration file defining source subvolumes, snapshot locations, backup targets, and retention policies.
SUBCOMMANDS
run
Create snapshots and run backup routinessnapshot
Only create snapshots (no backups)resume
Resume incomplete backupsdryrun
Show what would be done without making changesstats
Display statisticslist
List configured itemsclean
Delete outdated snapshots
CAVEATS
Only works with btrfs filesystems. Remote backups require SSH access and btrfs on the remote host. Retention policies should be tested with dryrun first.
SEE ALSO
btrfs(8), btrfs-send(8), snapper(8)
