Skip to main content

Kubernetes

Add the Coroot helm chart repo:

helm repo add coroot https://coroot.github.io/helm-charts
helm repo update coroot

Next, install the Coroot Operator:

helm install -n coroot --create-namespace coroot-operator coroot/coroot-operator

Install the Coroot Community Edition. This chart creates a minimal Coroot Custom Resource:

helm install -n coroot coroot coroot/coroot-ce \
--set "clickhouse.shards=2,clickhouse.replicas=2"

The helm chart

Forward the Coroot port to your machine:

kubectl port-forward -n coroot service/coroot-coroot 8080:8080

Then, you can access Coroot at http://localhost:8080

Upgrade

The Coroot Operator for Kubernetes automatically upgrades all components.

Uninstall

To uninstall Coroot run the following command:

helm uninstall coroot -n coroot
helm uninstall coroot-operator -n coroot

Troubleshooting

Pod Security Standards

The Coroot node agent requires privileged access for eBPF monitoring, host filesystem access, and container inspection. If the node agent fails to start due to Pod Security violations (common in Talos clusters), allow privileged workloads in the namespace:

kubectl label ns coroot pod-security.kubernetes.io/enforce=privileged
Looking for 24/7 support from the Coroot team? Subscribe to Coroot Enterprise:Start free trial