The fastest way to install and keep PgDesigner up to date:
brew tap vmkteam/tap
brew install pgdesigner Update to the latest version:
brew upgrade pgdesigner Download the binary for your platform from GitHub Releases:
| Platform | Architecture | File |
|---|---|---|
| macOS | Apple Silicon (arm64) | pgdesigner-darwin-arm64.tar.gz |
| macOS | Intel (amd64) | pgdesigner-darwin-amd64.tar.gz |
| Linux | amd64 | pgdesigner-linux-amd64.tar.gz |
| Linux | arm64 | pgdesigner-linux-arm64.tar.gz |
| Windows | amd64 | pgdesigner-windows-amd64.zip |
# Linux / macOS
curl -L https://github.com/vmkteam/pgdesigner/releases/latest/download/pgdesigner-linux-amd64.tar.gz | tar xz
sudo mv pgdesigner /usr/local/bin/
# Verify
pgdesigner --version Run PgDesigner in a container — useful for CI/CD pipelines and headless environments:
# Pull the latest image
docker pull ghcr.io/vmkteam/pgdesigner:latest
# Run with a local project directory
docker run --rm -v $(pwd):/work -p 8080:8080 ghcr.io/vmkteam/pgdesigner:latest
# Lint only (no UI)
docker run --rm -v $(pwd):/work ghcr.io/vmkteam/pgdesigner:latest lint /work/schema.pgd Available tags: latest, x.y.z (specific version). Images are published for linux/amd64 and linux/arm64.
Requires Go 1.25+ and pnpm:
git clone https://github.com/vmkteam/pgdesigner.git
cd pgdesigner
make build The binary is at ./bin/pgdesigner. Source builds are licensed under PolyForm Noncommercial — commercial use requires a purchased license.
Purchased binaries are signed and notarized by Apple — they open without warnings. If you build from source, macOS may show "unidentified developer". To allow:
xattr -d com.apple.quarantine pgdesigner Or: System Settings → Privacy & Security → Allow.
See also