Error Knowledge Base DOCKER no_matching_manifest

no matching manifest for linux/amd64 in the manifest list entries

Docker found the image tag, but no manifest matches your OS or CPU architecture, so the image is not built for your platform.

What This Error Means

Docker found the image tag, but no manifest matches your OS or CPU architecture, so the image is not built for your platform.

How to Fix It

List tags and confirm the tag exists (registry UI/API varies by registry).

Check platform/arch and try an explicit platform pull:docker pull --platform linux/amd64 <image:tag>

Ensure the repository path is correct and you are pulling from the intended registry.

Why It Happens

The tag does not exist in the repository.

The image exists but does not include a manifest for your OS/arch.

You are referencing the wrong registry or repository path.

How to Verify

Pull the corrected tag/platform and confirm it succeeds.

Run docker image inspect <image:tag> after a successful pull.

Examples

no matching manifest for linux/amd64 in the manifest list entries
no matching manifest for linux/arm64/v8 in the manifest list entries

Prevention Tips

Publish multi-arch images when you support multiple platforms.

Use explicit tags and avoid relying on latest.

Need help or found a mistake? Contact RepoFlow support for questions.

Join our mailing list