Pod status CreateContainerError
The image was pulled, but the container runtime failed to create the container — bad command, missing mount target, or a name/volume conflict.
Error: failed to create containerd containerfailed to generate container spec Meaning
Unlike CreateContainerConfigError (missing Secret/ConfigMap), this comes from the runtime itself. The Events section of kubectl describe pod has the real message: executable not found, subPath errors, “container name already in use”, or a read-only filesystem problem.
Common causes
- command/args reference an executable not in the image
- subPath or volume mount target invalid
- Leftover container with the same name on the node
- Runtime/storage problem on the node
⚡ Quick fix
- Read the event message with kubectl describe pod
- Fix command/args or mounts
- Delete the pod so it’s recreated (or cordon a bad node)
Detailed fix by platform
Kubernetes
kubectl describe pod web-7d9c -n app | sed -n '/Events/,$p'
How to diagnose
- Events — Exact runtime message
- Command — Does the binary exist in the image?
- Node — Only on one node?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
- ACR unauthorized Azure Container Registry: unauthorized: authentication required, visit https://aka.ms/acr/authorization (AKS ErrImagePull 401)
- admission webhook denied the request Error from server: admission webhook "validate.nginx.ingress.kubernetes.io" denied the request
- BackoffLimitExceeded Job has reached the specified backoff limit (BackoffLimitExceeded)
Most viewed in Kubernetes
- provided port is not in the valid range spec.ports[0].nodePort: Invalid value: 80: provided port is not in the valid range. The range of valid ports is 30000-32767
- the object has been modified Operation cannot be fulfilled on deployments.apps "x": the object has been modified; please apply your changes to the latest version and try again
- error converting YAML to JSON error converting YAML to JSON: yaml: line 12: did not find expected key
Other ways to find it
Where this error sits
Origin: Platform & cloud. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 13 Oct 2026