Troubleshooting Guide: Resolving The Named Manifest is Not Known to the Registry Error

In this guide, we will discuss the steps to resolve the 'The Named Manifest is Not Known to the Registry' error, which is commonly encountered when working with Docker registries. This error usually occurs when trying to pull or push a Docker image to a registry, and the registry does not recognize the image manifest.

Table of Contents

  1. Understanding the Error
  2. Troubleshooting Steps
  1. FAQ
  2. Related Links

Understanding the Error

Before diving into the troubleshooting steps, it's essential to understand what this error means. The 'Named Manifest is Not Known to the Registry' error occurs when the Docker registry does not recognize the image manifest associated with the image you are trying to push or pull. This can happen due to various reasons, such as incorrect image name or tag, registry issues, authentication problems, or outdated Docker versions.

Troubleshooting Steps

Step 1: Verify Image Name and Tag

The first step is to ensure that you have provided the correct image name and tag while pushing or pulling the image. Double-check the image name and tag and make sure they match the ones in the registry. For example:

docker pull your-registry-url/your-image-name:your-tag

Step 2: Check for Registry Issues

Next, verify if there are any issues with the registry itself. Check the registry's status page to ensure that it's up and running. You can also test the registry by pushing or pulling a different image.

If you're using a self-hosted registry, ensure that it's configured correctly and that it's accessible from the machine where you're running Docker.

Step 3: Ensure Proper Authentication

If you are using a private registry or have enabled authentication, make sure you have the correct credentials to access the registry. You can authenticate using the docker login command:

docker login your-registry-url -u your-username -p your-password

Step 4: Update Docker

If you're using an older version of Docker, it might not support the latest image manifest formats, causing compatibility issues with the registry. Update Docker to the latest version to ensure compatibility.

For example, on Ubuntu, you can update Docker using the following commands:

sudo apt-get update
sudo apt-get upgrade docker-ce

Step 5: Clear Local Cache

If none of the above steps work, try clearing the local cache of Docker images and metadata. This can be done using the docker system prune command:

docker system prune -a

Warning: This command will remove all stopped containers, networks, images, and build caches not in use. Be cautious while using this command.

After clearing the local cache, try pulling or pushing the image again.


What is a Docker image manifest?

A Docker image manifest is a JSON file containing metadata about the image, such as image layers, size, and configuration.

How do I check the Docker version?

You can check the Docker version by running the following command:

docker version

How do I check the available images on my local machine?

You can list the available images on your local machine using the following command:

docker images

Can I use multiple registries with Docker?

Yes, you can use multiple registries with Docker by specifying the registry URL when pushing or pulling images.

How do I create a new image tag in Docker?

You can create a new image tag using the docker tag command:

docker tag source-image:source-tag target-image:target-tag

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.