You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ian 78d6fd7ff5
Merge pull request #1 from GoliathLabs/master
8 months ago
.github Added: Dependabot.yml 8 months ago
hooks Update mutli-arch builds on docker hub 3 years ago
scripts Fix location of scripts in cron 1 year ago
tests Add tests 1 year ago
.dockerignore Clean test scripts 4 years ago
.gitignore Complete sample docker-compose.yaml 4 years ago
.pre-commit-config.yaml Add pre-commit and lint 1 year ago
.travis.yml Update travis 4 years ago
Dockerfile Make config dir a volume to presist restic configs 1 year ago
LICENSE Initial commit 5 years ago
Makefile Add tests 1 year ago Update readme to show proper location of restore script 1 year ago
docker-compose.yaml Complete sample docker-compose.yaml 4 years ago

Restic Backup

Build Status


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 or Minio
AWS_SECRET_ACCESS_KEY Required for writing to S3 or Minio
B2_ACCOUNT_ID Required for writing to B2
B2_ACCOUNT_KEY Required for writing to B2
BACKUP_DEST /backups Destination to store backups (See restic documenation)
CLEANUP_COMMAND Optional restic arguments for forget to execute after backups to clean older ones out (eg. "--prune --keep-last 2"). See forget
CRON_SCHEDULE If you want to periodic incremental backups on a schedule, provide it here. By default we just backup once and exit
OPT_ARGUMENTS Any additional arguments to provide to the restic command
RESTIC_PASSWORD Passphrase to use for encryption
PATH_TO_BACKUP /data The path to the directory you wish to backup
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



Hostname is used for identifying what you are backing up. You may want to specify this on your container.

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 /scripts/ That should be that! Eg. docker exec my_backup_container /scripts/

Backup to any rclone destination

This image also contains rclone. This allows you to target any destination supported by rclone. Check out the official documentation to see how to configure this.

Rather than having to use an exec shell inside the container, I recommend configuring via the backup destination. For example: rclone::ftp,env_auth:/test-restic and then passing all config values via the environment.

Pre/post backup/restore scripts

Before and after any backup or restore, scripts located in /scripts/{backup,restore}/{before,after}/ will be executed. This can be used to do things like snapshotting a database before backing it up and restoring the contents.