Public | Automated Build

Last pushed: 3 months ago
Short Description
Full Description


This image runs pg_dump to backup data using cronjob to folder /backup


docker run -d \
    --env \
    --env PG_PORT=27017 \
    --env PG_USER=admin \
    --env PG_PASSWORD=password \
    --volume host.folder:/backup

Moreover, if you link jmcarbo/docker-postgres-backup to a postgres container (e.g. tutum/mysql) with an alias named pg, this image will try to auto load the host, port, user, pass if possible.

docker run -d -p 27017:27017 -p 28017:28017 -e PG_PASS="mypass" --name pg postgres
docker run -d --link pg:pg -v host.folder:/backup jmcarbo/docker-postgres-backup


POSTGRES_HOST      the host/ip of your postgres database
POSTGRES_PORT      the port number of your postgres database
POSTGRES_USER      the username of your postgres database
POSTGRES_PASSWORD      the password of your postgres database
POSTGRES_DB        the database name to dump. Default: `--all-databases`
EXTRA_OPTS      the extra options to pass to pg_dump command
CRON_TIME       the interval of cron job to run pg_dump. `0 0 * * *` by default, which is every day at 00:00
MAX_BACKUPS     the number of backups to keep. When reaching the limit, the old backup will be discarded. No limit by default
INIT_BACKUP     if set, create a backup when the container starts
INIT_RESTORE_LATEST if set, restores latest backup

INIT_RESTORE_URL restore from minio url ex: myminio/bla/file.sql 
MINIO_HOST name of minio host ex: myminio
MINIO_ACCESS_KEY minio access key
MINIO_SECRET_KEY minio secret key

Restore from a backup

See the list of backups, you can run:

docker exec docker-postgres-backup ls /backup

To restore database from a certain backup, simply run:

docker exec docker-postgres-backup / /backup/2015.08.06.171901
Docker Pull Command
Source Repository

Comments (2)
a year ago

The fix is to change the line in to "
if psql -h db -p 5432 -U username < $1 ;then

a year ago

I cannot seem to use the restore script.
Command: "docker exec container_name / /backup/2016.10.19.000001.sql"
Results in: " => Restore database from /backup/2016.10.19.000001.sql
\pset: unknown option: -Uusername
psql: could not set printing parameter "-Uusername"
Restore failed
=> Done
It seems the script is incorrect, these are the contents: "

export PGPASSWORD="password"

export MINIO_HOST=
if [ -n "${MINIO_HOST}" ]; then
export RESTIC_PASSWORD=password
export RESTIC_REPOSITORY=s3:/restic
echo "=> Restore database from $1"
if psql -hdb -P -Uusername < $1 ;then
echo " Restore succeeded"
echo " Restore failed"
echo "=> Done"

The documentation states that "-P" specifies printing options, in the style of \pset. Note that here you have to separate name and value with an equal sign instead of a space.

Yet without any options the line continues to specify the username.