Troubleshooting

Diagnostics for the platform itself — the under cluster, the kMetal operator, and the components it installs.

Installation — an install or upgrade that does not converge: registry credentials, stalled components, CRDs that never establish.

Platform — a component that installed but is not behaving: controllers, webhooks, hosted control planes.

Networking — the under-cluster network: Kube-OVN, the provider networks, MetalLB address pools.

For problems inside a tenant cluster or with a tenant workload, see Tenant Guide → Troubleshooting.