nebirhos/docker-postgres-replication

README

Postgres Streaming Replication

Enhanced version of the official Postgres image to support streaming replication out of the box.

Postgres-replication is meant to be used with orchestration systems such as Kubernetes.

Run with Docker Compose

docker-compose up

Run with Docker

To run with Docker, first run the Postgres master:

docker run -p 127.0.0.1:5432:5432 --name postgres-master nebirhos/postgres-replication

Then Postgres slave(s):

docker run -p 127.0.0.1:5433:5432 --link postgres-master \
           -e POSTGRES_MASTER_SERVICE_HOST=postgres-master \
           -e REPLICATION_ROLE=slave \
           -t nebirhos/postgres-replication

Notes

Replication is set up at container start by putting scripts in the /docker-entrypoint-initdb.d folder. This way the original Postgres image scripts are left untouched.

See Dockerfile and official Postgres image for custom environment variables.