gem-hunter

PostgreSQL binaries for Linux, macOS and Windows. Asset target names describe an ABI; check the support policy for tested environments, feature coverage, support tiers and known limitations. Musl archives are dynamically linked.

Installation packages use the pattern postgresql-<version>-<target>.<extension>, where<version> is the PostgreSQL version, <target> is the target tuple for the platform, and <extension> is the archive file extension. To find the <target> tuple for your platform run rustc -vV and look for the value of the host field. The target tuple can be obtained programmatically in rust using the target-tuple crate.

The supported target tuples are:

Windows ARM64 packages require PostgreSQL 16 or newer. Other targets support PostgreSQL 14–18. Previously published archives for retired targets remain available; future releases support only the targets above.

This project uses a versioning scheme that is compatible with PostgreSQL versioning. The version comprises <postgres major>.<postgres minor>.<release>, where <release> is the release for this project's build of a version of PostgreSQL. New releases of this project will be made when new versions of PostgreSQL are released or new builds of existing versions are required for bug fixes, new targets, etc.

The build workflow calls the same per-OS Bash scripts that can be run locally. Pass the full project version (<postgres major>.<postgres minor>.<release>) and target tuple. Linux also requires a Docker platform, and Windows requires a vcpkg tuplet; matching values are listed in the target inventory.

Run these examples from the repository root:

# Linux GNU or musl (requires Docker with Buildx and privileged container support)
./scripts/build-linux.sh 18.6.0 x86_64-unknown-linux-gnu linux/amd64
./scripts/build-linux.sh 18.6.0 x86_64-unknown-linux-musl linux/amd64

# macOS (requires Xcode command line tools and Homebrew)
./scripts/build-macos.sh 18.6.0 aarch64-apple-darwin
# On an Intel Mac, use x86_64-apple-darwin instead.

# Windows (run in Git Bash with the Visual Studio developer environment inherited)
./scripts/build-windows.sh 18.6.0 x86_64-pc-windows-msvc x64-windows
./scripts/build-windows.sh 18.6.0 aarch64-pc-windows-msvc arm64-windows

macOS and Windows builds require a host matching the target architecture. On Windows, install Visual Studio C++ build tools, Python, and Chocolatey first, then launch Git Bash from a developer command prompt configured for the target architecture. PostgreSQL versions before 16 also require Strawberry Perl at C:\Strawberry; ARM64 builds require PostgreSQL 16 or newer. The scripts install the remaining Homebrew, Python, Chocolatey, or vcpkg dependencies as needed.

The scripts resolve the repository root from their own location and install into postgresql-<version>-<target> there. Set INSTALL_DIRECTORY to an absolute path to choose another destination. macOS clones into postgresql-src; remove that generated directory before starting a fresh build. Windows uses RUNNER_TEMP, falling back to TMPDIR or /tmp, for source and build files; use a fresh temporary directory when changing versions or targets.

On macOS and Windows, the installation includes runtime dependencies and can be tested with:

cd postgresql-18.6.0-aarch64-apple-darwin # Use your installation directory.
../scripts/test.sh 18.6.0

Linux installations can be tested in the build image:

docker run --rm --platform linux/amd64 \
  --volume "$PWD/postgresql-18.6.0-x86_64-unknown-linux-gnu:/opt/test" \
  --volume "$PWD/scripts/test.sh:/opt/test/test.sh:ro" \
  --volume "$PWD/scripts/postgresql-versions.sh:/opt/test/postgresql-versions.sh:ro" \
  postgresql-build:latest /bin/sh -c 'cd /opt/test && ./test.sh 18.6.0'

Archive creation and release uploads are handled by the GitHub Actions workflow.

CI job IDs and artifact names use the target tuples. Required build checks use Build / <target>, independently of the selected GitHub runner.

PostgreSQL is covered under The PostgreSQL License.