Kubernetes
- Community Edition
- Enterprise Edition
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"
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 automatically upgrades all Coroot components (Coroot server, node agent, cluster agent) as long as their image versions are not pinned in the Coroot Custom Resource. If you have specified a particular image for a component, the operator keeps that version, and you upgrade by changing the image tag in the Custom Resource.
To upgrade the operator itself:
helm repo update coroot
helm upgrade -n coroot coroot-operator coroot/coroot-operator
Uninstall
To uninstall Coroot run the following command:
helm uninstall coroot -n coroot
helm uninstall coroot-operator -n coroot
Coroot Enterprise Edition is a paid subscription (from $1 per CPU core/month) that offers extra features and priority support. To install the Enterprise Edition, you'll need a license. Start your free trial today.
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 Enterprise Edition.This chart creates a minimal Coroot Custom Resource:
helm install -n coroot coroot coroot/coroot-ee \
--set "licenseKey=COROOT-LICENSE-KEY-HERE,clickhouse.shards=2,clickhouse.replicas=2"
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 automatically upgrades all Coroot components (Coroot server, node agent, cluster agent) as long as their image versions are not pinned in the Coroot Custom Resource. If you have specified a particular image for a component, the operator keeps that version, and you upgrade by changing the image tag in the Custom Resource.
To upgrade the operator itself:
helm repo update coroot
helm upgrade -n coroot coroot-operator coroot/coroot-operator
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