Install the agent
The agent connects your environment to nullplatform so it can run actions, respond to events, and execute workflows inside your infrastructure. Setting it up takes three steps:
- Authenticate the agent: create an API key with the agent and ops roles.
- Install the agent: use Helm for production clusters, or run the binary locally for development.
- Create a notification channel: connect the agent to platform events. Without this, the agent registers but stays idle.
Which install method is right for me?
| Install with Helm | Local install | |
|---|---|---|
| Best for | Production and Kubernetes clusters | Local development and testing |
| Requires Kubernetes | Yes | No |
| Setup time | A few minutes | Under a minute |
Before you start
Both methods need an API key with the agent and ops roles. See Authenticate the agent to set one up.
Pick your path
- Install with Helm: for Kubernetes environments and production.
- Local install: run the agent directly in your terminal. No Kubernetes required.
tip
Installing on Kubernetes and pulling agent code from a private GitHub repo? See Authenticate private repos with a GitHub App for a more secure alternative to personal access tokens.