Docker 'manifest unknown' errors in CI: causes and how to diagnose them

The 'manifest unknown' error means a registry found the repository but could not locate the specific tag or reference requested, and it is not an authentication failure. Common causes include a tag that was never pushed or was misnamed, a missing platform entry in a multi-architecture manifest list, a client and registry mismatch over manifest formats, or a tag or digest deleted after it was resolved. The error appears quickly with nothing downloaded, while other tags from the same repository may still pull normally. The message combines a daemon sentence and a registry error code, which is why it looks redundant. The article recommends verifying pushed tags in the publishing job so failures surface at the source rather than in downstream pulls.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)
Log in to join the discussion and vote.
Log in