Self-host

Self-hosting

The PulseBoard edge runtime, PulseAgent, the tracer SDKs and every cloud poller integration are MIT-licensed and available on GitHub. Run with Docker, bare metal, or Kubernetes.

Docker (single-tenant)

docker run -p 8080:8080 \
  -v /data/pulse:/data \
  ghcr.io/pulseboard/pulseboard:latest \
  --port=8080 --data=/data

Docker (with Mimir backend)

docker run -p 8080:8080 \
  ghcr.io/pulseboard/pulseboard:latest \
  --port=8080 --data=/data \
  --mimir-url=http://mimir:9009 \
  --mimir-write-tenant=acme \
  --mimir-read-tenant=acme

Kubernetes (Helm)

helm repo add pulseboard https://charts.pulseboard.dev
helm install pulseboard pulseboard/pulseboard \
  --set ingress.host=metrics.acme.com \
  --set mimir.url=http://mimir.observability.svc:9009

Key flags & env

Flag / Env	Purpose
`--port` / `PULSE_PORT`	HTTP listen port (default 8080)
`--data` / `PULSE_DATA`	Local data directory
`--mimir-url`	Upstream Mimir for long-term metric storage
`--oidc-issuer`	OIDC provider issuer URL for multi-tenant auth
`--region` / `PULSE_REGION`	Region label for synthetic probes
`--gitops-url`	Git repository URL for GitOps sync
`--ai-provider`	Custom `IAiProvider` adapter

References

See DEPLOYMENT.md for the full Helm chart, Kubernetes manifests and environment-variable reference.