KubernetesMid

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:Error or Init:CrashLoopBackOff in kubectl 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

  1. 1
    See which init container is stuck
    kubectl describe pod POD_NAME

    Look at the Init Containers section and its state, and at the Events.

  2. 2
    Read the failing init container's logs
    kubectl logs POD_NAME -c INIT_CONTAINER_NAME

    Add --previous if 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

Sources

Kubernetes documentation (kubernetes.io), read 18 Nov 2026. The docs version selector listed v1.33 to v1.37.

Search

Search cheat sheets and projects