btrbk/btrbk.conf.example

#
# Example btrbk configuration file
#
#
# Please refer to the btrbk.conf(5) man-page for more details.
#
# Note that the options can be overridden in the
# volume/subvolume/target sections.
#


# Directory in which the btrfs snapshots are created. Relative to
# <volume-directory> of the volume section.
# If not set, the snapshots are created in <volume-directory>.
#
# If you want to set a custom name for the snapshot (and backups),
# use the "snapshot_name" option within the subvolume section.
#
# NOTE: btrbk does not autmatically create this directory, and the
# snapshot creation will fail if it is not present.
#
snapshot_dir               _btrbk_snap

# Perform incremental backups (set to "strict" if you want to prevent
# creation of non-incremental backups if no parent is found).
incremental                yes

# Always create snapshots (set to "ondemand" to only create snapshots
# if the target volume is reachable).
snapshot_create            always

# Resume missing backups if the target volume is reachable again (set
# to "no" if you don't want to resume missing backups).
resume_missing             yes

# ssh key for ssh volumes/targets
ssh_identity               /etc/btrbk/ssh/id_ed25519
ssh_user                   root

# Preserve weekly/monthly backups from given day of week
preserve_day_of_week       sunday

# Preserve matrix for snapshots
snapshot_preserve_daily    14
snapshot_preserve_weekly   0
snapshot_preserve_monthly  0

# Preserve matrix for backups
target_preserve_daily      20
target_preserve_weekly     10
target_preserve_monthly    all

# Make sure the deletion of subvolumes is committed to disk when btrbk terminates
btrfs_commit_delete        after

# Enable compatibility mode for btrfs-progs < 3.17.
# Set this either globally or in a specific "target" section.
#btrfs_progs_compat         yes


#
# Volume section: "volume <volume-directory>"
#
#   <volume-directory>  Directory of a btrfs volume (or subvolume)
#                       containing the subvolume to be backuped
#                       (usually the mount-point of a btrfs filesystem
#                       mounted with subvolid=0 option)
#
# Subvolume section: "subvolume <subvolume-name>
#
#   <subvolume-name>    Subvolume to be backuped, relative to
#                       <volume-directory> in volume section.
#
# Target section: "target <type> <volume-directory>"
#
#   <type>              Backup type, currently only "send-receive".
#   <volume-directory>  Directory of a btrfs volume (or subvolume)
#                       receiving the backups.
#
# NOTE: The parser does not care about indentation, this is only for
# human readability. The options always apply to the last section
# encountered, overriding the corresponding option of the upper
# section. This means that the global options must be set before any
# "volume" section.
#

volume /mnt/btr_system
  subvolume  root_gentoo
    target send-receive    /mnt/btr_ext/_btrbk
    target send-receive    /mnt/btr_backup/_btrbk

  subvolume  kvm
    # use different preserve matrix for kvm backups
    target_preserve_daily  7
    target_preserve_weekly 4

    target send-receive    /mnt/btr_ext/_btrbk
      target_preserve_weekly 0

    target send-receive    /mnt/btr_backup/_btrbk


volume /mnt/btr_data
  subvolume  home
    target send-receive    /mnt/btr_backup/_btrbk
    target send-receive    ssh://backup.my-remote-host.com/mnt/btr_backup


volume /mnt/btr_ext
  subvolume data
    target send-receive    /mnt/btr_backup/_btrbk


volume ssh://my-remote-host.com/mnt/btr_pool
  subvolume data_0
    snapshot_dir  snapshots/btrbk
    snapshot_name data_main
    target send-receive    /mnt/btr_backup/_btrbk/my-remote-host.com


# Resume backups from remote host which runs its own btrbk instance
# creating snapshots for "home" in "/mnt/btr_pool/btrbk_snapshots".
volume ssh://my-remote-host.com/mnt/btr_pool
  subvolume home
    snapshot_dir  btrbk_snapshots
    snapshot_preserve_daily  all
    snapshot_create          no
    resume_missing           yes

    target send-receive    /mnt/btr_backup/_btrbk/my-remote-host.com