Installation

PulseStream deploys to your Kubernetes cluster via Helm. The agent runs in its own namespace and connects to the PulseStream control plane using a provisioning token — no API keys to manage manually.

Prerequisites

• Kubernetes 1.25+
• Helm 3.10+
• kubectl configured with cluster access
• A PulseStream account (sign up)

Quick install

1. Generate a provisioning token

In the PulseStream dashboard, go to Settings → Connection and click Generate Provisioning Token. This creates a short-lived token (expires in 30 minutes) and a YAML manifest.

2. Apply the provisioning secret

Copy the YAML manifest and apply it to your cluster:

kubectl apply -f agent-provision.yaml

3. Install the agent

helm repo add pulsestream https://charts.pulsestream.ai
helm repo update

helm install pulsestream-agent pulsestream/pulsestream-agent \
  --namespace pulsestream-agent \
  --create-namespace

The agent automatically reads the provisioning secret, exchanges it for permanent credentials, and connects to the control plane.

Tip

No API keys to copy-paste. The agent handles credential exchange automatically during startup.

Verify the installation

kubectl get pods -n pulsestream-agent

You should see the agent pod running. Head to your PulseStream dashboard — the connection status indicator should turn green within 30 seconds.

Next steps

Agent Configuration Configure namespaces, resource limits, and advanced agent options.

Troubleshooting Agent not connecting? Check common issues.