btrfs-sxbackup 0.3.4

Incremental btrfs snapshot backups with push/pull support via SSH

Btrfs snapshot backup utility * Push/pull support via SSH * Syslog logging * Compression of transferred data

System dependencies

Required

The following packages have to be available on both source and destination * btrfs-progs

The system executing btrfs-backup requires * python3

Optional

• ssh (for remote push/pull, not required for local operation)

• lzop (for compression support if desired)

• pv (provides progress indication if installed)

Installation

pip install <btrfs-sxbackup-archive.tar.gz>

Setup

• when using ssh, public/private key authentication should be set up

Usage examples

btrfs-sxbackup.py ssh://[e-mail]:/ /backup/myhost

Pulls snapshot backups of / on remote host myhost.org to local subvolume /backup/myhost

btrfs-sxbackup.py / ssh://[e-mail]:/backup/myhost

Pushes snapshot backups of local subvolume / to remote subvolume /backup/myhost on host mybackupserver.org

usage: btrfs-sxbackup [-h] [-sm SOURCE_MAX_SNAPSHOTS]
                      [-dm DESTINATION_MAX_SNAPSHOTS]
                      [-ss SOURCE_CONTAINER_SUBVOLUME] [-c] [-li LOG_IDENT]
                      [-q] [--version]
                      source_subvolume destination_container_subvolume

positional arguments:
  source_subvolume      Source subvolume to backup. Local path or SSH url.
  destination_container_subvolume
                        Destination subvolume receiving snapshots. Local path
                        or SSH url.

optional arguments:
  -h, --help            show this help message and exit
  -sm SOURCE_MAX_SNAPSHOTS, --source-max-snapshots SOURCE_MAX_SNAPSHOTS
                        Maximum number of source snapshots to keep (defaults
                        to 10).
  -dm DESTINATION_MAX_SNAPSHOTS, --destination-max-snapshots DESTINATION_MAX_SNAPSHOTS
                        Maximum number of destination snapshots to keep
                        (defaults to 10).
  -ss SOURCE_CONTAINER_SUBVOLUME, --source-container-subvolume SOURCE_CONTAINER_SUBVOLUME
                        Override path to source snapshot container subvolume.
                        Both absolute and relative paths are possible.
                        (defaults to 'sxbackup', relative to source subvolume)
  -c, --compress        Enables compression, requires lzop to be installed on
                        both source and destination
  -li LOG_IDENT, --log-ident LOG_IDENT
                        Log ident used for syslog logging, defaults to script
                        name
  -q, --quiet           Do not log to STDOUT
  --version             show program's version number and exit