WAL-G Docker Images

This repository contains Docker images for WAL-G, a backup tool for PostgreSQL, MySQL, MongoDB, Redis, and other databases.

Features

• 🚀 Automated Builds: Automatically builds new Docker images when WAL-G releases new versions
• 🔄 Multiple Variants: Supports all WAL-G database variants (PostgreSQL, MySQL, MongoDB, Redis, Greenplum, FDB, SQL Server)
• 🏗️ Multi-Architecture: Supports both linux/amd64 and linux/arm64 platforms
• 🛡️ Security: Runs as non-root user, uses distroless base images
• 📦 Docker Hub: Images are published to chekkan/wal-g
• 🤖 Dependabot: Automatically updates dependencies

Usage

Pull the latest image

# PostgreSQL variant (default)
docker pull chekkan/wal-g:latest-pg

# MySQL variant
docker pull chekkan/wal-g:latest-mysql

# MongoDB variant
docker pull chekkan/wal-g:latest-mongo

# Redis variant
docker pull chekkan/wal-g:latest-redis

Run WAL-G

# Show help
docker run --rm chekkan/wal-g:latest-pg

# Run with your configuration
docker run --rm \
  -e WALG_S3_PREFIX="s3://your-bucket/path" \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -v /var/lib/postgresql/data:/var/lib/postgresql/data \
  chekkan/wal-g:latest-pg \
  backup-push /var/lib/postgresql/data

Run Other Commands

You can also run other commands within the container:

# Interactive bash shell
docker run -it chekkan/wal-g:latest-pg /bin/bash

# Run environment inspection
docker run --rm chekkan/wal-g:latest-pg printenv

# Run any other command
docker run --rm chekkan/wal-g:latest-pg ls -la /usr/local/bin/

Available Tags

• latest - Latest PostgreSQL variant
• latest-pg - Latest PostgreSQL variant
• latest-mysql - Latest MySQL variant
• latest-mongo - Latest MongoDB variant
• latest-redis - Latest Redis variant
• latest-gp - Latest Greenplum variant
• latest-fdb - Latest FoundationDB variant
• latest-sqlserver - Latest SQL Server variant
• v3.0.7 - Specific version (PostgreSQL variant)
• v3.0.7-mysql - Specific version with variant

Build Arguments

The Dockerfile supports the following build arguments:

• WAL_G_VERSION: Version of WAL-G to install (default: "latest")
• WAL_G_VARIANT: Database variant to install (default: "pg")

Available Variants

• pg - PostgreSQL
• mysql - MySQL/MariaDB
• mongo - MongoDB
• redis - Redis
• gp - Greenplum
• fdb - FoundationDB
• sqlserver - SQL Server

Automated Builds

This repository automatically:

1. ✅ Monitors the wal-g/wal-g repository for new releases
2. ✅ Skips pre-releases (only builds stable releases)
3. ✅ Builds Docker images for all supported database variants
4. ✅ Supports both linux/amd64 and linux/arm64 architectures
5. ✅ Publishes images to Docker Hub
6. ✅ Creates git tags matching WAL-G versions

Development

Manual Build

# Build locally
docker build -t wal-g:local .

# Build specific variant
docker build --build-arg WAL_G_VARIANT=mysql -t wal-g:mysql .

# Build specific version
docker build --build-arg WAL_G_VERSION=v3.0.7 -t wal-g:v3.0.7 .

# Build for specific platform
docker build --platform linux/amd64 -t wal-g:amd64 .
docker build --platform linux/arm64 -t wal-g:arm64 .

Local Testing with Docker Compose

# Build and test PostgreSQL variant
docker-compose --profile pg up --build wal-g-pg

# Build and test MySQL variant  
docker-compose --profile mysql up --build wal-g-mysql

# Build and test MongoDB variant
docker-compose --profile mongo up --build wal-g-mongo

# Build and test Redis variant
docker-compose --profile redis up --build wal-g-redis

Example Configurations

The examples/ directory contains sample configurations:

• postgresql-docker-compose.yml - Complete PostgreSQL setup with WAL-G
• wal-archive.sh - WAL archiving script for PostgreSQL
• wal-restore.sh - WAL restore script for PostgreSQL

To use the PostgreSQL example:

cp examples/postgresql-docker-compose.yml docker-compose.override.yml
# Edit the file to add your S3 credentials
docker-compose up postgres

Trigger Manual Build

You can manually trigger a build via GitHub Actions:

1. Go to the "Actions" tab
2. Select "Build WAL-G Docker Images"
3. Click "Run workflow"
4. Optionally specify a WAL-G version

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Projects

• WAL-G - The backup tool this project packages