MORAINE(1)

NAME
moraine - snapshot backup over SSH/rsync and rclone

SYNOPSIS
moraine [-c CONFIG] COMMAND [OPTIONS]

DESCRIPTION
moraine creates timestamped, hard-linked snapshots of local files on a remote target. Each run looks like a complete tree, but files that have not changed share disk with the previous snapshot through hard links, so keeping history costs almost nothing. Snapshots can be listed, pruned with a GFS retention policy, and individual files or whole trees restored.

Two backends are supported: rsync over SSH, and rclone (cloud, SFTP, SMB, WebDAV, S3 and more). Targets and schedules are described in a TOML configuration file.

OPTIONS

-c, --config CONFIG
    Path to the configuration file (default: moraine.toml).

-h, --help
    Print help.

-V, --version
    Print version, including the git hash and build date.

COMMANDS

init
    Write an example configuration file to start from.

verify
    Check the SSH connection, key, sources and that the target is writable.

run [--dry-run] [--target NAME]
    Run a backup for all targets, or a selected one.

list --target NAME
    List the snapshots on a target.

prune [--dry-run] [--target NAME]
    Delete old snapshots according to the target's retention policy.

FILES

moraine.toml
    Configuration file: one [[target]] block per backup destination.

SEE ALSO
rsync(1), ssh(1), rclone(1)

AUTHOR
Jonaz Thern <info@thern.io>