{"record":{"id":"0cd3f1c32261ddf5","repo":"kubernetes/kubernetes","slug":"imagepullbackoff","errorCode":null,"errorMessage":"ImagePullBackOff","messagePattern":"ImagePullBackOff","errorType":"error_code","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/kubelet/images/types.go","lineNumber":29,"sourceCode":"distributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\npackage images\n\nimport (\n\t\"context\"\n\t\"errors\"\n\n\tv1 \"k8s.io/api/core/v1\"\n\truntimeapi \"k8s.io/cri-api/pkg/apis/runtime/v1\"\n)\n\nvar (\n\t// ErrImagePullBackOff - Container image pull failed, kubelet is backing off image pull\n\tErrImagePullBackOff = errors.New(\"ImagePullBackOff\")\n\n\t// ErrImageInspect - Unable to inspect image\n\tErrImageInspect = errors.New(\"ImageInspectError\")\n\n\t// ErrImagePull - General image pull error\n\tErrImagePull = errors.New(\"ErrImagePull\")\n\n\t// ErrImageNeverPull - Required Image is absent on host and PullPolicy is NeverPullImage\n\tErrImageNeverPull = errors.New(\"ErrImageNeverPull\")\n\n\t// ErrInvalidImageName - Unable to parse the image name.\n\tErrInvalidImageName = errors.New(\"InvalidImageName\")\n)\n\n// ImageManager provides an interface to manage the lifecycle of images.\n// Implementations of this interface are expected to deal with pulling (downloading),\n// managing, and deleting container images.\n// Implementations are expected to abstract the underlying runtimes.","sourceCodeStart":11,"sourceCodeEnd":47,"githubUrl":"https://github.com/kubernetes/kubernetes/blob/b882c60b4023bdf09264c2d5d30a2cadebc240fb/pkg/kubelet/images/types.go#L11-L47","documentation":"Error \"ImagePullBackOff\" thrown in kubernetes/kubernetes.","triggerScenarios":"Container image pull has failed repeatedly and the kubelet is backing off before retrying; root cause is registry unreachable, bad credentials, or missing image tag.","commonSituations":"See trigger scenarios.","solutions":["Check the image name and tag for typos and that the image exists in the registry","Verify registry credentials via imagePullSecrets are correct and not expired","Confirm network access from the node to the registry (proxy, firewall, DNS)","Check registry rate limits or quota if pulls are failing with 429 errors"],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"b882c60b4023bdf09264c2d5d30a2cadebc240fb","analyzedAt":"2026-08-07T04:07:48.144Z","schemaVersion":2},"datasetVersion":"2026-08-07T07:17:06.508Z"}