Repository navigation
Troubleshooting
Only issues documented in the repository.
kaironctl doctor (a hint per problem), kaironctl selftest, ./scripts/must-gather.sh, kaironctl sysdump, kaironctl logs, kaironctl events.
Expected behaviour after an ambiguous commit. Run kaironctl recover NAME to see the diagnosis, cross-check destinationRuntimeFound/destinationRuntimeStatus (a Prepared session phase is not proof the destination did not commit), then choose ConfirmDestinationCommitted, ConfirmDestinationNotCommitted or ForceAbort with a real reason. Alerts: KaironMigrationNeedsRecoveryStuck, KaironMigrationFailureRateHigh. See docs/runbook-migration-failures.md.
CRDs and RBAC were not applied first. Apply deploy/crd.yaml and deploy/rbac.yaml from the tag (Helm applies crds/ only on first install).
kairon-ui and kairon-node must be upgraded together because the console hop is now TLS by default.
It serves HTTPS. Use https:// in KAIRON_UI_URL and set KAIRON_UI_CA for a self-signed certificate.
--image-cache-dir must be a path the profile allows (the lab's profile permits only /var/lib/kairon-node/image-cache/**); a systemd unit needs it in ReadWritePaths=.
Agent-session screen and spec.engine need FluxVM newer than 0.4.8.
Other runbooks in docs/: backup/restore, node fence, recovery drill, cert rotation, Velero, VM export.
Kairon wiki, drafted for v0.10.2. Source of truth: the repository README and docs/. Apache-2.0.