Files
Pulse/deploy/helm/pulse

Pulse Helm Chart

This chart deploys the Pulse hub (web UI + API) and, optionally, the Docker monitoring agent.

Installing from GHCR

helm registry login ghcr.io
helm install pulse oci://ghcr.io/rcourtman/pulse-chart \
  --version $(curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/VERSION) \
  --namespace pulse \
  --create-namespace

Replace the inline curl command if you need to pin to a specific release. The chart version tracks the Pulse release version (e.g., Pulse v4.24.0 → chart 4.24.0).

Common Values

Key Description Default
persistence.enabled Persist /data using a PVC. Disable for ephemeral testing. true
ingress.enabled Create an Ingress resource. Configure hosts/TLS via ingress.hosts and ingress.tls. false
server.secretEnv Manage sensitive env vars (API tokens, auth secrets). Enable create or point at an existing secret. {}
agent.enabled Deploy the Docker agent as a DaemonSet or Deployment. Requires access to the Docker socket by default. false

See values.yaml for the full list of overridable settings.

Local Development

Install from the working copy when testing chart changes:

helm upgrade --install pulse ./deploy/helm/pulse \
  --namespace pulse \
  --create-namespace \
  --set persistence.enabled=false \
  --set server.secretEnv.create=true \
  --set server.secretEnv.data.API_TOKENS=dummy-token

For more deployment details (ingress, agent, persistence options), refer to docs/KUBERNETES.md.