CreateContainerError ☸️ Kubernetes

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.

Seen on: Kubernetes

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

  1. Read the event message with kubectl describe pod
  2. Fix command/args or mounts
  3. Delete the pod so it’s recreated (or cordon a bad node)

Detailed fix by platform

Kubernetes

  1. kubectl describe pod web-7d9c -n app | sed -n '/Events/,$p'

How to diagnose

  1. Events — Exact runtime message
  2. Command — Does the binary exist in the image?
  3. 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:

🧠 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.