This project provides Docker images to periodically back up a MongoDB database to AWS S3, and to restore from the backup as needed.
services:
mongo:
image: mongo
environment:
MONGO_USER: user
MONGO_PASSWORD: password
backup:
image: wwalczyszyn/mongo-backup-s3:16
environment:
SCHEDULE: '@weekly' # optional
BACKUP_KEEP_DAYS: 7 # optional
PASSPHRASE: passphrase # optional
S3_REGION: region
S3_ACCESS_KEY_ID: key
S3_SECRET_ACCESS_KEY: secret
S3_BUCKET: my-bucket
S3_PREFIX: backup
MONGO_HOST: mongo
MONGO_DATABASE: dbname
MONGO_USER: user
MONGO_PASSWORD: password
- Images are tagged by the major MongoDB version supported:
7
. - The
SCHEDULE
variable determines backup frequency. See go-cron schedules documentation here. Omit to run the backup immediately and then exit. - If
PASSPHRASE
is provided, the backup will be encrypted using GPG. - Run
docker exec <container name> sh backup.sh
to trigger a backup ad-hoc. - If
BACKUP_KEEP_DAYS
is set, backups older than this many days will be deleted from S3. - Set
S3_ENDPOINT
if you're using a non-AWS S3-compatible storage provider.
Caution
DATA LOSS! All database objects will be dropped and re-created.
docker exec <container name> sh restore.sh
Note
If your bucket has more than a 1000 files, the latest may not be restored -- only one S3 ls
command is used
docker exec <container name> sh restore.sh <timestamp>
ALPINE_VERSION
determines Mongo version compatibility. See build-and-push-images.yml
for the latest mapping.
DOCKER_BUILDKIT=1 docker build --build-arg ALPINE_VERSION=3.14 .
cp template.env .env
# fill out your secrets/params in .env
docker compose up -d
This project is a fork of @eeshugerman's postgres-backup-s3.
The purpose of this fork is to adopt the solution for MongoDB.