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.