Skip to content
This repository was archived by the owner on Apr 26, 2026. It is now read-only.

Releases: StefanMarkmann/postgres-backup-s3cmd

v1.0.3

09 Jan 00:18
2f3c101

Choose a tag to compare

Added

  • Interactive shell aliases: backup, restore, list, cleanup, delete, run now map to the corresponding /backup.sh scripts.
  • Welcome banner now lists those alias commands alongside the absolute script paths.

Documentation

  • README notes the availability of interactive aliases inside the container.

v1.0.2

08 Jan 17:04
b206a67

Choose a tag to compare

  • Scheduled backups now use cron (cronie) instead of go-cron when SCHEDULE is set.
  • Updated alpine versions
  • Welcome messages on bash

v1.0.1

08 Jan 12:00
73bea11

Choose a tag to compare

  • Updated alpine versions
  • Fixed go cron syntax in k8s

v1.0.0

08 Jan 11:14

Choose a tag to compare

🚀 postgres-backup-s3cmd v1.0.0

Simple PostgreSQL dump backups to S3-compatible storage using s3cmd.

Highlights

  • Works with any S3-compatible storage — MinIO, Ceph RGW, Wasabi, DigitalOcean Spaces, Backblaze B2, AWS S3
  • Multi-architecture — amd64 and arm64 support
  • PostgreSQL 15, 16, 17, 18 — One image per major version
  • Built-in compression — zstd with frame checksums for integrity verification

Features

Backup

  • Single database backup (pg_dump) or full cluster (pg_dumpall)
  • GPG encryption with PASSPHRASE
  • zstd compression (corruption detected on restore)
  • Scheduled backups via go-cron
  • Automatic retention cleanup

Restore

  • Restore from latest backup
  • Restore from specific timestamp

Operations

  • list.sh — View backups (table, summary, latest modes)
  • cleanup.sh — Manual retention with --dry-run
  • delete.sh — Delete specific backup

Observability

  • Fail-fast startup with S3 connectivity test
  • Machine-parseable backup statistics
  • Clear logging with timestamps

Quick Start

services:
  backup:
    image: stefanmarkmann/postgres-backup-s3cmd:18
    environment:
      SCHEDULE: '@daily'
      BACKUP_KEEP_DAYS: 7
      S3_BUCKET: my-backups
      S3_ENDPOINT: https://s3.example.com
      S3_ACCESS_KEY_ID: your-key
      S3_SECRET_ACCESS_KEY: your-secret
      POSTGRES_HOST: postgres
      POSTGRES_DATABASE: mydb
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword

Image Tags

PostgreSQL Tag
18 stefanmarkmann/postgres-backup-s3cmd:18
17 stefanmarkmann/postgres-backup-s3cmd:17
16 stefanmarkmann/postgres-backup-s3cmd:16
15 stefanmarkmann/postgres-backup-s3cmd:15

No latest tag — Use explicit versions for predictable deployments.

Acknowledgements

Inspired by eeshugerman/postgres-backup-s3 (archived).


📖 Documentation · 🐳 Docker Hub