Self-Hosted Agent — Binary Install

If you don't want a container and don't want systemd — maybe you're on macOS for development, Windows via WSL, or a process manager you already know — the binary install is the bare-metal option. We ship Linux x86_64, macOS arm64, and Windows x86_64.

Download

# Linux x86_64
curl -fsSL https://releases.monpg.app/collector/latest/linux-amd64/monpg-collector   -o monpg-collector
chmod +x monpg-collector

# macOS arm64
curl -fsSL https://releases.monpg.app/collector/latest/darwin-arm64/monpg-collector   -o monpg-collector
chmod +x monpg-collector

# Windows x86_64
curl -fsSL https://releases.monpg.app/collector/latest/windows-amd64/monpg-collector.exe   -o monpg-collector.exe

Run

MONPG_AGENT_TOKEN=mpa_... MONPG_API_ENDPOINT=https://api.monpg.app MONPG_DB_HOST=localhost MONPG_DB_PORT=5432 MONPG_DB_USER=monpg_monitor MONPG_DB_PASSWORD=... MONPG_DB_NAME=postgres MONPG_DB_SSLMODE=require MONPG_DATA_DIR=./monpg-state ./monpg-collector

Verify checksum

Each release ships with a .sha256 alongside it:

curl -fsSL https://releases.monpg.app/collector/latest/linux-amd64/monpg-collector.sha256   | sha256sum -c -

Cosign signature

For production, verify the keyless cosign signature. This proves the binary was built by our deploy workflow, not slipped in by something that compromised the release host:

cosign verify-blob --certificate-identity   https://github.com/Devopzone-Eood/monpg/.github/workflows/deploy.yml@refs/heads/main   --certificate-oidc-issuer https://token.actions.githubusercontent.com   --signature monpg-collector.sig monpg-collector

supervisord example

If you're using supervisord rather than systemd:

[program:monpg-collector]
command=/opt/monpg/monpg-collector
directory=/opt/monpg
user=monpg
autorestart=true
environment=MONPG_AGENT_TOKEN="mpa_...",MONPG_API_ENDPOINT="https://api.monpg.app",MONPG_DB_HOST="localhost",...

launchd, runit, NSSM on Windows — same pattern. Whatever you trust to keep a long-running process up.