Search for the exact string from kubectl get pods, kubectl describe, or your logs. Each page links to the line in the Kubernetes source (v1.37.2) that produces the message, and to the official documentation for the fix.
| Error |
What it usually means |
| CrashLoopBackOff |
Your container keeps exiting and Kubernetes keeps restarting it with a growing delay. How to find the real error in four commands. |
| ImagePullBackOff |
The node can’t pull the container image. How to tell a wrong name from a missing pull secret from an unreachable registry. |
| InvalidImageName |
The image reference in the pod spec isn’t a valid reference, so the kubelet won’t even try to pull it. |
| CreateContainerConfigError |
A ConfigMap, Secret, or key the container needs doesn’t exist in the pod’s namespace, so the container can’t be configured. |
| CreateContainerError |
The runtime accepted the pod but failed to create the container: a bad command, a mount problem, or a name conflict. |
| Init:CrashLoopBackOff |
An init container keeps failing, so the app containers never start. How to read init container status and logs. |
| OOMKilled |
The container exceeded its memory limit and the kernel killed it, exit code 137. How to tell a bad limit from a leak. |
| Liveness probe failed |
The kubelet is restarting a container because its liveness probe keeps failing. Often the probe, not the app, is wrong. |
| Readiness probe failed |
The pod is running but not Ready, so Services send it no traffic. How to find what the probe objects to. |
| Stuck in ContainerCreating |
The pod is scheduled, but the node can’t finish setting it up: sandbox, network, volumes, or image. How to tell which. |
| Stuck in Terminating |
A pod was deleted but never goes away. Finalizers, unreachable nodes, and when force deletion is safe. |
| Error |
What it usually means |
| FailedScheduling |
The pod is Pending because no node passed the scheduler’s filters. How to read the message clause by clause. |
| Evicted |
The kubelet removed the pod to protect a node that ran short of memory, disk, or process IDs. How to find the real cause. |
| Node NotReady |
A node stopped reporting healthy. What Kubernetes does about it, and how to find out why from the node itself. |
| Cannot evict pod: disruption budget |
A drain or eviction is blocked by a PodDisruptionBudget. How to see which budget and fix it without causing an outage. |
| Error |
What it usually means |
| PVC stuck in Pending |
A PersistentVolumeClaim isn’t binding. When that’s normal, and how to find the provisioning error when it isn’t. |
| FailedMount |
The kubelet can’t mount a volume into the pod. How to tell an attach problem from a mount problem from a missing object. |
| Multi-Attach error |
A ReadWriteOnce disk is still attached to another node, so the new pod can’t start. Common during rollouts and after node failures. |
| node(s) didn’t match PersistentVolume’s node affinity |
The pod’s volume is pinned to a zone or node where nothing can run the pod. How to see where the volume lives. |
| Error |
What it usually means |
| Forbidden: cannot list resource |
An RBAC denial. How to read who, what verb, which resource, and which namespace from the message, and grant exactly that. |
| x509: certificate signed by unknown authority |
The client doesn’t trust the certificate it was shown. Common with kubectl, private registries, and webhooks. |
| The connection to the server localhost:8080 was refused |
kubectl has no cluster configured, so it falls back to localhost:8080. How to point it at your kubeconfig. |
| Forbidden: violates PodSecurity |
Pod Security Admission rejected the pod. How to read which rule it broke and fix the pod rather than the policy. |
| Forbidden: exceeded quota |
A ResourceQuota blocked the pod. How to see what’s used, what’s left, and why pods without requests are rejected. |
| Failed calling webhook |
An admission webhook is unreachable or slow, so the API server rejects requests. How to unblock the cluster safely. |
| Error |
What it usually means |
| ProgressDeadlineExceeded |
A Deployment’s rollout stopped making progress. The cause is on the new pods; here’s how to find them and roll back. |
| Field is immutable |
An apply tried to change a field Kubernetes doesn’t allow to change, such as a Deployment selector or a Job template. |
| Strict decoding error: unknown field |
The manifest contains a field the API server doesn’t recognise: a typo, wrong indentation, or a field from a newer version. |
| No matches for kind in version |
The cluster doesn’t serve this kind at this API version: a removed API after an upgrade, or a CRD that isn’t installed. |
| FailedGetResourceMetric |
The HorizontalPodAutoscaler can’t read CPU or memory metrics, so it won’t scale. How to check metrics-server and requests. |