What This Error Means
Docker could not find the requested image/tag/manifest (or it does not match 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.
Common CLI Output
Error pushing to registry: Tag does not exist: <tag>Prevention Tips
- Publish multi-arch images when you support multiple platforms.
- Use explicit tags and avoid relying on
latest.