Go to file
Ian 275c575706
Merge pull request #9 from GoliathLabs/master
Added: Dependabot.yml
2021-12-27 21:53:42 -08:00
.github Added: Dependabot.yml 2021-12-20 20:23:24 +01:00
hooks Try to do multi-arch on docker hub 2019-08-05 17:54:39 -07:00
tests Final fix for travis? 2019-08-05 18:07:53 -07:00
.dockerignore Clean test scripts 2018-05-13 10:31:31 -07:00
.gitignore Add gitignore for sample compose artifacts 2019-02-01 17:04:09 -08:00
.pre-commit-config.yaml Add pre-commit hooks 2021-12-01 14:34:15 -08:00
.travis.yml Remove travis arm build 2019-02-01 17:01:50 -08:00
Dockerfile Try to do multi-arch on docker hub 2019-08-05 17:54:39 -07:00
Dockerfile.armhf Try to do multi-arch on docker hub 2019-08-05 17:54:39 -07:00
LICENSE Initial commit 2017-03-18 17:00:44 -07:00
Makefile Add pre-commit hooks 2021-12-01 14:34:15 -08:00
Readme.md Update readme 2019-08-05 17:56:07 -07:00
backup.sh Add support for pre/post scripts 2019-01-28 11:59:46 -08:00
cron-exec.sh Fix env parsing for variables with spaces 2019-02-01 17:02:13 -08:00
docker-compose.yaml Fix reference to old Dockerfile 2019-08-05 18:00:22 -07:00
healthcheck.sh Add healthcheck to Docker image 2019-02-01 13:48:00 -08:00
restore.sh Add support for pre/post scripts 2019-01-28 11:59:46 -08:00
start.sh Fix env parsing for variables with spaces 2019-02-01 17:02:13 -08:00
verify.sh Add restore script and restore test 2017-06-28 23:28:48 -07:00

Readme.md

Duplicity Backup

Build Status

Instructions

Mount any directories you'd like to back up as a volume and run

Env Variables

Variable Default Description
AWS_ACCESS_KEY_ID Required for writing to S3
AWS_DEFAULT_REGION Required for writing to S3
AWS_SECRET_ACCESS_KEY Required for writing to S3
BACKUP_DEST file:///backups Destination to store backups (See duplicity documenation)
BACKUP_NAME backup What the name for the backup should be. If using a single store for multiple backups, make sure this is unique
CLEANUP_COMMAND An optional duplicity command to execute after backups to clean older ones out (eg. "remove-all-but-n-full 2")
CRON_SCHEDULE If you want to periodic incremental backups on a schedule, provide it here. By default we just backup once and exit
FLOCK_WAIT 60 Seconds to wait for a lock before skipping a backup
FTP_PASSWORD Used to provide passwords for some backends. May not work without an attached TTY
FULL_CRON_SCHEDULE If you want to periodic full backups on a schedule, provide it here. This requires an incremental cron schedule too
GPG_KEY_ID The ID of the key you wish to use. See Encryption section below
OPT_ARGUMENTS Any additional arguments to provide to the duplicity backup command
PASSPHRASE Correct.Horse.Battery.Staple Passphrase to use for GPG
PATH_TO_BACKUP /data The path to the directory you wish to backup. If you want to backup multiple, see the tip below
RESTORE_ON_EMPTY_START Set this to "true" and if the $PATH_TO_BACKUP is empty, it will restore the latest backup. This can be used for auto recovery from lost data
SKIP_ON_START Skips backup on start if set to "true"
VERIFY_CRON_SCHEDULE If you want to verify your backups on a schedule, provide it here

Encryption

By default Duplicity will use a symettric encryption using just your passphrase. If you wish to use a GPG key, you can add a ro mount to your ~/.gnupg directory and then provide the GPG_KEY_ID as an environment variable. The key will be used to sign and encrypt your files before sending to the backup destination.

Need to generate a key? Install gnupg and run gnupg --gen-key

Tips

Missing dependencies?

Please file a ticket! Duplicity supports a ton of backends and I haven't had a chance to validate that all dependencies are present in the image. If something is missing, let me know and I'll add it

Getting complains about no terminal for askpass?

Instead of using FTP_PASSWORD, add the password to the endpoint url

Backing up more than one source directory

Duplicity only accepts one target, however you can refine that selection with --exclude and --include arguments. The below example shows how this can be used to select multiple backup sources

OPT_ARGUMENTS="--include /home --include /etc --exclude '**'"
PATH_TO_BACKUP="/"

Backing up from another container

Mount all volumes from your existing container with --volumes-from and then back up by providing the paths to those volumes. If there are more than one volumes, you'll want to use the above tip for mulitple backup sources

Restoring a backup

On your running container, execute /restore.sh. That should be that! Eg. docker exec my_backup_container /restore.sh