INSTALL

PGXN / source install

pgRDF ships PGXN metadata at the repository root:

  • META.json
  • Makefile
  • README.md
  • LICENSE

The PGXN build path is source-based. It shells out to cargo pgrx package, so the build host needs the Rust and pgrx toolchain in addition to PostgreSQL.

Prebuilt binary artifacts remain on the GitHub Releases page as the existing pgrdf-<version>-pg<PG_MAJOR>-glibc-<arch>.tar.gz matrix plus SHA256SUMS. The PGXN archive is the source distribution, not a replacement for those per-architecture binaries.

Prerequisites

  • PostgreSQL 14, 15, 16, or 17 development installation
  • pg_config for the target PostgreSQL major
  • Rust 1.91 or newer
  • cargo-pgrx 0.16
  • one-time cargo pgrx init for the target PostgreSQL installation

Example one-time pgrx setup:

cargo install cargo-pgrx --locked --version '^0.16'
cargo pgrx init --pg17 /path/to/pg_config

Install via PGXN client

pgxn install pgrdf --pg_config /path/to/pg_config
psql -d yourdb -c 'CREATE EXTENSION pgrdf;'

If you prefer to build directly from the unpacked PGXN source archive:

make PG_CONFIG=/path/to/pg_config
make PG_CONFIG=/path/to/pg_config install
psql -d yourdb -c 'CREATE EXTENSION pgrdf;'

Maintainer release artifact

Build the PGXN-ready source archive from a tagged commit:

make dist

This emits pgrdf-<version>.zip, with the standard pgrdf-<version>/... directory prefix expected by PGXN Manager. The GitHub release workflow also attaches this zip alongside the existing binary tarballs.