Skip to content

Configuration

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

Configuration

Only items found in the source are listed. Defaults and full semantics: charts/kairon/values.yaml, docs/, and -h on each binary.

Helm

  • values.yaml is the evaluation profile; values-production.yaml is the hardened overlay.
  • Keys named in the docs: ui.tls.secretName, ui.insecureHttp, ui.ingress.backendProtocol, console.enabled, console.tls.secretName, console.tls.serverName, console.tls.enabled, node.cpuPinning, node.thirdPartyCSIDrivers, migration.stateHostPath.

kairon-controller flags (from cmd/kairon-controller/main.go)

-interval, -health-addr, -require-capable-label, -leader-elect (-leader-elect-namespace, -leader-elect-lease-name), -webhook-addr, -webhook-tls-cert, -webhook-tls-key, -migration-max-concurrent-per-node, -migration-max-concurrent-cluster, -cordon-evacuate (+ -strategy, -min-retry-interval), -memory-pressure-evacuate, -node-maintenance, -drs-mode (recommend|automatic), -drs-interval, -drs-threshold-percent, -drs-max-moves, -drs-signal, -stale-evacuation, -cilium-attach, -cilium-policy-sync, -fleet-enabled, -atlas-url, -atlas-token-file.

Default ports per README: health :32301, webhook :8443.

kairon-node flags (from cmd/kairon-node/main.go)

-fluxvm-url, -default-backend, -image-root, -image-cache-dir, -export-dir, -vfio-allowlist, -health-addr, -register-node, -node-ip, -reserved-cpus, -cpu-manager-state, -network-default-deny, -memory-reclaim, -pressure-report, -virtual-networks, -csi-socket, -third-party-csi-drivers.

Migration: -migration-addr, -migration-port, -migration-ca, -migration-cert, -migration-key, -migration-server-name, -migration-state-dir, -migration-adapter-socket, -migration-require-encrypted, -migration-heartbeat-ttl.

Console relay: -console-addr, -console-token, -console-tls-cert, -console-tls-key.

Default ports per README: health :32302, mTLS peer :9443, console :8090.

kairon-ui flags (from cmd/kairon-ui/main.go)

-listen, -tls-cert, -tls-key, -insecure-http, -token, -allow-unauthenticated, -namespace-scoping-enabled, -trusted-proxy-header, -trusted-proxy-cidrs, -image-store-dir, -image-store-public-url, -atlas-url, -atlas-token-file, -atlas-console-url, -web-dir, -version. Listens on :18082 over HTTPS by default.

Environment variables found in the source

UI: KAIRON_UI_LISTEN, KAIRON_UI_TLS_CERT, KAIRON_UI_TLS_KEY, KAIRON_UI_INSECURE_HTTP, KAIRON_UI_TOKEN, KAIRON_UI_ALLOW_UNAUTHENTICATED, KAIRON_UI_SESSION_SECRET, KAIRON_UI_USERS_JSON, KAIRON_UI_NAMESPACE_SCOPING_ENABLED, and the OIDC set KAIRON_UI_OIDC_ISSUER_URL, _CLIENT_ID, _CLIENT_SECRET, _REDIRECT_URL, _SCOPES, _ADMIN_GROUPS, _NAMESPACE_GROUPS, _GROUPS_CLAIM, _USERNAME_CLAIM.

Clients: KAIRON_UI_URL and KAIRON_UI_CA (for a self-signed dashboard certificate; named in the v0.10.0 release notes). Console hop: KAIRON_NODE_CONSOLE_TOKEN, KAIRON_NODE_CONSOLE_CA, KAIRON_NODE_CONSOLE_PORT, KAIRON_NODE_CONSOLE_SERVER_NAME. Agent: KAIRON_LLM_URL (adds a model summary to kaironctl agent diagnose).

Not every variable is documented here; check the code before relying on one.

Clone this wiki locally