Download pgpipe

Single static binary, ~21 MB. No runtime dependencies. Verify the SHA-256 checksum before running, especially on production hosts.

Run with Docker .deb / .rpm Cheatsheet

Run with Docker

The fastest way to try pgpipe.

A small Dockerfile + docker-compose.yml spin up a source database, a destination database, and pgpipe wired between them. The dashboard opens at http://localhost:8080.

1. Grab the files

# Make a working directory
mkdir pgpipe-demo && cd pgpipe-demo

# Pull the four files
BASE="https://www.pghorizon.com/downloads/pgpipe/v1.1.4/docker"
curl -fsSL $BASE/Dockerfile          -O
curl -fsSL $BASE/docker-compose.yml  -O
curl -fsSL $BASE/pgpipe.example.yaml -o pgpipe.yaml
curl -fsSL $BASE/init-source.sql     -O
curl -fsSL $BASE/init-dest.sql       -O

2. Bring the stack up

# Build the pgpipe image (pulls the published binary)
# and start everything in one go
docker compose up -d --build

# Watch pgpipe logs
docker compose logs -f pgpipe

# Open the dashboard
open http://localhost:8080

3. See replication in action

# Insert a row in the source database
docker compose exec source-db psql -U postgres source_db \
  -c "INSERT INTO public.greetings(message) VALUES ('hello from pgpipe');"

# A moment later, see it in the destination
docker compose exec dest-db psql -U postgres dest_db \
  -c "SELECT * FROM public.greetings;"

# Tear it all down (and delete data)
docker compose down -v

Logging into the dashboard

On the very first docker compose up, pgpipe generates a random admin password and prints it once to the logs. Open the dashboard at http://localhost:8080 and use these credentials:

# Just the password (cleanest, always works)
docker compose exec pgpipe cat /var/lib/pgpipe/pgpipe-admin.password

# Or grep the full first-run banner from the logs
docker compose logs pgpipe | grep -A 6 "FIRST RUN — DASHBOARD"

Username is admin. The password is auto-generated on first run, persisted to /var/lib/pgpipe/pgpipe-admin.password (mode 0600), and survives restarts. The "FIRST RUN" log banner only appears the first time — after that, the file is the only copy.

To set your own password instead, edit pgpipe.yaml → server.auth.password before bringing the stack up. For production, prefer an environment variable like PGPIPE_DASHBOARD_PASSWORD over a value baked into YAML.

Container image

Dockerfile

Alpine-based, multi-arch (amd64 / arm64), pulls the verified pgpipe binary at build time. ~50 MB final image.

Compose

docker-compose.yml

Source PG · Destination PG · pgpipe wired together. Production-safe defaults — no benchmark hacks.

Config

pgpipe.example.yaml

Annotated reference config: source, destination, ordering, batching, state backend, observability.

Running pgpipe against your own databases? Drop the source-db and dest-db services from the compose file and edit pgpipe.yaml with your real hostnames. The Dockerfile builds the same image either way.

Linux packages

Platform	File	Size	Download
Debian / Ubuntu (amd64) sha256: 42fccff6473499795a7e5b84ab1abcef2f559bf88b2b8bba88d6219dee69d762	`pgpipe_1.1.4_amd64.deb`	5.9 MB	Download
Debian / Ubuntu (arm64) sha256: a18389c702597774028ef0170fba66a6ab93b4a352048bf1570505b3bc08771c	`pgpipe_1.1.4_arm64.deb`	5.1 MB	Download
RHEL / Rocky / Fedora (x86_64) sha256: 8a0d4457b9471f22653f839730ab3f96a5a291d362af94b62b24c9bc378a8328	`pgpipe-1.1.4-1.x86_64.rpm`	7.7 MB	Download
RHEL / Rocky / Fedora (aarch64) sha256: 88f2b7fc2349a8d8a582da662bb580f2ea8c8fb8a4b10fdc251cd736bd9e7dcd	`pgpipe-1.1.4-1.aarch64.rpm`	7.0 MB	Download

Verification & companion files

checksums.txt — SHA-256 for all binaries
THIRD_PARTY_LICENSES.txt — open-source notices

Debian / Ubuntu (.deb)

wget https://www.pghorizon.com/downloads/pgpipe/v1.1.4/pgpipe_1.1.4_amd64.deb
sudo apt install ./pgpipe_1.1.4_amd64.deb
sudo systemctl enable --now pgpipe

RHEL / Rocky / Fedora (.rpm)

wget https://www.pghorizon.com/downloads/pgpipe/v1.1.4/pgpipe-1.1.4-1.x86_64.rpm
sudo dnf install ./pgpipe-1.1.4-1.x86_64.rpm
sudo systemctl enable --now pgpipe

First time using pgpipe?

The Docker Compose quickstart gets you replicating in under a minute, with a sample source and destination already wired up.

See the quickstart

pgpipe v1 is provided as-is, free of charge, with no support SLA. For commercial support and managed deployments, talk to us.