Files
Pulse/docs/KUBERNETES.md
rcourtman dcdbee3c5c feat: Add in-app help system with HelpIcon component
Add contextual help icons throughout the UI to improve feature
discoverability. Users can click (?) icons to see explanations
with examples for settings they might not understand.

- HelpIcon component with click-to-open popover
- Centralized help content registry in /content/help/
- FeatureTip component for dismissible contextual tips
- Help added to: alert delay, AI endpoints, update channel
2026-01-07 09:22:23 +00:00

2.1 KiB

☸️ Kubernetes (Helm)

Deploy Pulse to Kubernetes using the official Helm chart.

🚀 Installation

  1. Install (OCI chart, recommended)

    helm upgrade --install pulse oci://ghcr.io/rcourtman/pulse-chart \
      --namespace pulse \
      --create-namespace
    
  2. Access

    kubectl -n pulse port-forward svc/pulse 7655:7655
    

    Open http://localhost:7655 to complete setup.

If you installed using a Helm repository URL previously, you can keep using it. OCI is the preferred distribution format going forward.


⚙️ Configuration

Configure via values.yaml or --set flags.

Note

: API_TOKEN / API_TOKENS environment variables are legacy. Prefer managing API tokens in the UI after initial setup.

Parameter Description Default
service.type Service type (ClusterIP/LoadBalancer) ClusterIP
ingress.enabled Enable Ingress false
persistence.enabled Enable PVC for /data true
persistence.size PVC Size 8Gi
agent.enabled Enable legacy docker agent workload false

Note: the agent.* block is legacy and currently references pulse-docker-agent. For new deployments, prefer the unified agent (pulse-agent) where possible.

Example values.yaml

ingress:
  enabled: true
  className: nginx
  hosts:
    - host: pulse.example.com
      paths:
        - path: /
          pathType: Prefix

server:
  env:
    - name: TZ
      value: Europe/London
  secretEnv:
    create: true
    data:
      PULSE_AUTH_USER: "admin"
      PULSE_AUTH_PASS: "replace-me"

Apply with:

helm upgrade --install pulse oci://ghcr.io/rcourtman/pulse-chart -n pulse -f values.yaml

🔄 Upgrades

helm upgrade pulse oci://ghcr.io/rcourtman/pulse-chart -n pulse

Rollback:

helm rollback pulse -n pulse

⚠️ Troubleshooting

  • Check Pods: kubectl -n pulse get pods
  • Check Logs: kubectl -n pulse logs deploy/pulse
  • Scheduler Health:
    kubectl -n pulse exec deploy/pulse -- curl -s http://localhost:7655/api/monitoring/scheduler/health