LinuxCommandLibrary

btrbk

Backup tool for btrfs snapshots and subvolumes

TLDR

Print statistics about subvolumes and snapshots

$ sudo btrbk stats
copy
List configured subvolumes and snapshots
$ sudo btrbk list
copy
Print what would happen in a dry run
$ sudo btrbk -v dryrun
copy
Run backup routines with progress
$ sudo btrbk --progress -v run
copy
Only create snapshots for configured subvolumes
$ sudo btrbk snapshot
copy

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 routines
snapshot
Only create snapshots (no backups)
resume
Resume incomplete backups
dryrun
Show what would be done without making changes
stats
Display statistics
list
List configured items
clean
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)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community