Pod stuck in Init: an init container is failing
A pod status beginning with Init means an init container has not finished. Read its logs with kubectl logs -c, since the main container has not started yet.
What you see
Init:1/2,Init:ErrororInit:CrashLoopBackOffinkubectl get pods
What it means
Init containers run one after another before the app container starts, and each must finish successfully. A pod status that starts with Init: summarizes that stage: Init:N/M means N of M have completed, Init:Error means one failed, and Init:CrashLoopBackOff means one has failed repeatedly.
The main container's logs will be empty, because it has not started. The reason is in the init container.
How to confirm the cause
- 1See which init container is stuck
kubectl describe pod POD_NAME
Look at the
Init Containerssection and its state, and at the Events. - 2Read the failing init container's logs
kubectl logs POD_NAME -c INIT_CONTAINER_NAME
Add
--previousif it has restarted.
Causes and fixes
The init step itself fails
- HOW TO TELL
- The init container's log shows the error and a non-zero exit.
- ROOT CAUSE
- Its job, such as a migration, a config fetch or a connectivity check, did not succeed, so the pod cannot proceed.
- FIX
- Fix what the log shows: credentials, a missing config, a database that is not reachable yet.
It waits for a dependency that never appears
- HOW TO TELL
- The init container loops on a check and the pod stays at
Init:0/1. - ROOT CAUSE
- A wait-for-service loop has no way out when the dependency is down or misnamed.
- FIX
- Check the dependency exists and resolves. See the Service endpoints and DNS runbooks.
How to stop it coming back
- Keep init containers small and give them clear error output.
- Add a timeout to wait loops so a failure is loud.
- Do not rely on init containers for slow, unbounded work.
Keep going
- Runbook: Service has no endpoints or doesn't reach its pods
- Runbook: Can't resolve a Service name inside the cluster
- Runbook: CrashLoopBackOff: the container keeps crashing
- Cheat sheet: kubectl
- Lesson: the kubernetes topic in Learn
Sources
Kubernetes documentation (kubernetes.io), read 18 Nov 2026. The docs version selector listed v1.33 to v1.37.