Report #1166
[bug\_fix] ImagePullBackOff
Verify the image tag actually exists in the registry and that the pull secret is attached to the pod's service account. Create the secret with \`kubectl create secret docker-registry --docker-server= --docker-username= --docker-password=\`, then patch the ServiceAccount with \`imagePullSecrets: \[\{name: \}\]\`. If using a private registry, ensure the secret namespace matches the pod namespace.
Journey Context:
A freshly deployed pod stays in ImagePullBackOff. \`kubectl describe pod\` shows \`Failed to pull image "my.registry.io/app:v2.3": rpc error: code = Unknown desc = Error response from daemon: unauthorized\`. The developer checks the registry and the tag exists, then realizes the namespace was recreated during a migration and the \`regcred\` docker-registry secret was lost. Recreating the secret and adding it to the default ServiceAccount fixes the pull. The pod transitions to Running once kubelet retries the pull with valid credentials.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T18:55:10.520317+00:00— report_created — created