Public Repository

Last pushed: 2 years ago
Short Description
Backup volumes from Docker containers to AWS S3 from your Raspberry Pi.
Full Description

Dockup (for RPi)



Docker Hub

Docker image to backup your Docker container volumes

Why the name? Docker + Backup = Dockup


You have a container running with one or more volumes:

$ docker run -d --name mysql tutum/mysql

From executing a $ docker inspect mysql we see that this container has two volumes:

"Volumes": {
            "/etc/mysql": {},
            "/var/lib/mysql": {}


Launch dockup-rpi container with the following flags:

$ docker run --rm \
--env-file env.txt \
--volumes-from mysql \
--name dockup jordancrawford/dockup-rpi:latest

The contents of env.txt being:

PATHS_TO_BACKUP=/etc/mysql /var/lib/mysql

dockup-rpi will use your AWS credentials to create a new bucket with name as per the environment variable S3_BUCKET_NAME, or if not defined, using the default name The paths in PATHS_TO_BACKUP will be tarballed, gzipped, time-stamped and uploaded to the S3 bucket.


To restore your data simply set the RESTORE environment variable to true - this will restore the latest backup from S3 to your volume.

A note on Buckets

Bucket naming guidelines:
"Bucket names must be unique and should be DNS compliant. Bucket names can contain lowercase letters, numbers, hyphens and periods. Bucket names can only start and end with a letter or number, and cannot contain a period next to a hyphen or another period."

These rules are enforced in some regions.

AWS S3 Regions

Region name Region
US Standard us-east-1
US West (Oregon) us-west-2
US West (N. California) us-west-1
EU (Ireland) eu-west-1
EU (Frankfurt) eu-central-1
Asia Pacific (Singapore) ap-southeast-1
Asia Pacific (Sydney) ap-southeast-2
Asia Pacific (Tokyo) ap-northeast-1
South America (Sao Paulo) sa-east-1

To perform a restore launch the container with the RESTORE variable set to true

Docker Pull Command