Understand build failures

While Buildpacks help developers transform source code into container images that can run on any cloud, creating an error-free experience remains far from achieved.

This guide catalogs some commonly reported issues that may prevent image build completion and provides troubleshooting tips to help end-users navigate these issues.

If you would like to report an issue, please open a PR against this page using the included template (see bottom of page in Markdown).

Issue: ERROR: failed to build: failed to fetch base layers: saving image with ID "sha256:<sha256>" from the docker daemon: Error response from daemon: unable to create manifests file: NotFound: content digest sha256:<sha256>: not found

Occurs when: building and saving to a docker daemon Analysis: this seems to indicate a problem with the underlying image store in Docker Remediation: remove existing images with docker image prune (potentially, from multiple storage drivers if switching between overlay2 and containerd) Related error messages:

  • ERROR: failed to initialize analyzer: getting previous image: get history for image "test": Error response from daemon: NotFound: snapshot sha256:<sha256> does not exist: not found
  • ERROR: failed to export: saving image: failed to fetch base layers: open /tmp/imgutil.local.image.<identifier>/blobs/sha256/<sha256>: no such file or directory

For more information: