Installation¶

Docker¶

The quickest way to run pg2iceberg is with Docker:

docker pull ghcr.io/pg2iceberg/pg2iceberg:latest

Deploy to Kubernetes using the official Helm chart:

helm install pg2iceberg oci://ghcr.io/pg2iceberg/charts/pg2iceberg \
  --values values.yaml

Pre-built binaries are available on the GitHub releases page.

Linux (amd64)Linux (arm64)macOS

curl -L https://github.com/pg2iceberg/pg2iceberg/releases/latest/download/pg2iceberg_linux_amd64.tar.gz | tar xz
sudo mv pg2iceberg /usr/local/bin/

curl -L https://github.com/pg2iceberg/pg2iceberg/releases/latest/download/pg2iceberg_linux_arm64.tar.gz | tar xz
sudo mv pg2iceberg /usr/local/bin/

curl -L https://github.com/pg2iceberg/pg2iceberg/releases/latest/download/pg2iceberg_darwin_arm64.tar.gz | tar xz
sudo mv pg2iceberg /usr/local/bin/

Logical replication must be enabled. Set the following in postgresql.conf:

wal_level = logical

Then create a replication slot and publication for the tables you want to replicate:

SELECT pg_create_logical_replication_slot('pg2iceberg', 'pgoutput');
CREATE PUBLICATION pg2iceberg FOR TABLE my_table;

Note

The replication slot retains WAL until pg2iceberg consumes it. Monitor slot lag to avoid excessive disk usage on the primary.