Skip to content

Troubleshooting

Problem Fix
kubectl-oidc_login not found Install kubelogin, or use the CLI.
Signed in as the wrong GitHub account rm -rf ~/.kube/cache/oidc-login
forbidden Check kubectl auth whoami; see what you may do.
x509: certificate signed by unknown authority The kubeconfig is for another (or re-created) control plane: download it again.
CrashLoopBackOff, no matches for kind Install all of your operator’s CRDs.
ImagePullBackOff Check the image, or add credentials under Edit → Private image.
“doesn’t fit this control plane’s limits” Lower its CPU or memory limit, or another controller’s.
permission denied writing files Controllers run as non-root with a read-only home: write to /tmp.
Webhook errors, or connection refused on 9443 Set the webhook port.
No metrics Set where your controller serves them, and HTTPS for kubebuilder’s secure metrics; see Controllers.
  1. Network shows the tunnel running? If not, check docker logs ctrlplane-connector or the node in your tailnet.
  2. Can the connector’s machine reach the host itself?
  3. Does your client ignore HTTPS_PROXY? Use a forward.
  4. Tailscale: is the subnet advertised, and do your ACLs allow it?