Troubleshooting

kubefit doctor says Docker is stopped

Docker is installed but its daemon is not running. Start Docker Desktop (or your engine) and run doctor again. Kubernetes drills cannot start without it.

The cluster takes a long time to create

The first drill pulls the kind node image and, for some tracks, add-on images. Later drills reuse the cluster. If creation fails midway, run kubefit end and try again.

"cluster was built with a different profile"

CKS and CKNE need their own cluster configuration. Run kubefit end to delete the current clusters, then start the drill again and let kubefit rebuild with the right profile.

An LFCS drill cannot start the VM

Check limactl --version and that virtualization is available. The VM downloads an Ubuntu cloud image on first start. If the VM is in a bad state, kubefit end deletes it and the next drill recreates it. Practice disks are attached blank; setup unmounts anything Lima auto-mounted before a storage exercise begins.

A grade fails and I disagree

Read the check's message: graders report what they found. Common causes are a resource in the wrong namespace, a name that differs from the task, a selector that does not match labels, or a change made on the wrong node. kubefit task reprints the exact names. Graders check the live system, so kubectl get and kubectl describe show you what they see.

My rep did not show up on the site

Reps sync after each recorded drill. If you were offline, run kubefit sync. If the CLI reports it is not signed in, run kubefit login again.

Packs will not verify

The CLI refuses a pack whose signature does not match its built-in public key. Re-run kubefit packs. If it persists, the CLI is out of date for the packs the site publishes; install the current build.

Starting over

kubefit end

removes clusters, the VM and seeded files but keeps your reps, notes and token. To remove everything, delete ~/.kubefit as well.