Skip to content

Install

Susant Sahani edited this page Oct 18, 2026 · 1 revision

Install

Requirements (from the README)

  • A Kubernetes cluster whose VM hosts are Linux with /dev/kvm.
  • FluxVM on each VM host (default 127.0.0.1:7788).
  • For the eBPF edge: a kernel with BTF and cgroup v2, and dataplaneMode: ebpf.
  • For MachineSnapshot: the CSI snapshot stack.

Label each VM host:

kubectl label node worker-1 kairon.zyvor.dev/capable=true

Helm from GHCR

helm upgrade --install kairon oci://ghcr.io/zyvorai/charts/kairon \
  --version 0.10.2 -n kairon-system --create-namespace \
  -f https://raw.githubusercontent.com/zyvorai/kairon/v0.10.2/charts/kairon/values-production.yaml
  • Drop the -f overlay for the evaluation profile (webhook and namespace isolation off).
  • The production overlay turns on admission webhooks, namespace-scoped UI authorization, network default-deny and migration data-plane TLS.
  • Images are ghcr.io/zyvorai/kairon-{controller,node,ui,csi-node,csi-controller}:<version>; tags default to the chart appVersion.
  • Helm applies crds/ only on first install. When upgrading, apply CRDs from the same tag first: kubectl apply --server-side -f deploy/crd.yaml.

kaironctl

kaironctl install embeds the Helm chart (no helm binary needed): kaironctl install, or kaironctl install --profile production. Get the binary from the release (kaironctl-linux-amd64) or kubectl krew install kairon.

Later: kaironctl upgrade (keeps previous values; --check compares with latest), kaironctl config set KEY=VALUE, kaironctl history, kaironctl rollback.

Bare-metal host from a laptop

./scripts/deploy-remote.sh user@host --remote-build --with-controller --with-ui --with-console --self-test=quick

--dry-run prints the plan only. Details: docs/getting-started.md.

From source or raw manifests

make docker-build
helm upgrade --install kairon ./charts/kairon -n kairon-system --create-namespace
# or
kubectl apply -f deploy/crd.yaml -f deploy/rbac.yaml -f deploy/controller.yaml -f deploy/node.yaml

Add deploy/ui.yaml for the dashboard.

Breaking defaults to know (since v0.10.0)

The dashboard and the console relay hop serve/use TLS by default; upgrade kairon-ui and kairon-node together. See Releases.

MCP server image

ghcr.io/zyvorai/kairon-mcp, also listed in the MCP Registry as io.github.zyvorai/kairon. See docs/guides/hermes-mcp.md.

Clone this wiki locally