Install pgwd
Recommended: run the installer script, then verify with pgwd version.
Unix (macOS, Linux, WSL)
curl -fsSL https://get.pgwd.hermesrodriguez.com/install.sh | sh
Inspect before running: curl -fsSL … -o install.sh && less install.sh
Other installation methods
| Homebrew | brew install hrodrig/pgwd/pgwd |
| Go install | go install github.com/hrodrig/pgwd/cmd/pgwd@latest |
| Docker | docker pull ghcr.io/hrodrig/pgwd:v1.0.0 |
| GitHub Releases | .deb, .rpm, .tar.gz |
macOS first run (Gatekeeper)
Unsigned CLI binaries may show “Apple could not verify…” on the first pgwd run. This is download quarantine, not malware. Clear it once:
xattr -dr com.apple.quarantine "$(command -v pgwd)"
Or use System Settings → Privacy & Security → Open Anyway. Updated Homebrew casks clear quarantine on install.
Getting started
$ pgwd --print-sample-config > ./pgwd.conf # adjust $ pgwd -config ./pgwd.conf -dry-run -interval 0
Adjust pgwd.conf, set DSN and thresholds, then run a one-shot dry-run or daemon (-interval 60). SeeREADME.md.