Docker Manifest Unknown: Manifest Unknown

It usually occurs when the image does not exist on the local machine or in the registry you are looking for.

Suppose I have an image called repository-name/image-name:v1.0.0

For the following docker-compose.yaml

    # an example of docker compose
    version: '2'
    services:
      my-service-name:
        image: repository-name/image-name:v1.0.0
        restart: always

I get the same error when trying to use a docker image stored on the dockerhub in two situations:

When I type the wrong name of the image.

    # a wrong example
    version: '2'
    services:
      my-service-name:
        image: repository-name/image-wrong-name:v1.0.0
        restart: always

The command "docker-compose up", returns the error:

    /usr/bin/docker-compose up -d

    Pulling my-service-name (repository-name/image-wrong-name:v1.0.0)...
    ERROR: manifest for repository-name/image-wrong-name:v1.0.0 not found: manifest unknown: manifest unknown

Or if the version of the image doesn't exist.

    # a wrong example
    version: '2'
    services:
      my-service-name:
        image: repository-name/image-name:v1.0.1
        restart: always

I have the same error:

    /usr/bin/docker-compose up -d

    Pulling my-service-name (repository-name/image-name:v1.0.1)...
    ERROR: manifest for repository-name/image-name:v1.0.1 not found: manifest unknown: manifest unknown

Information about my environment:

• The operating system platform is Linux (Ubuntu 16.04);
• The output of the docker version command

    Client: Docker Engine - Community
     Version:           19.03.12
     API version:       1.40
     Go version:        go1.13.10
     Git commit:        48a66213fe
     Built:             Mon Jun 22 15:45:49 2020
     OS/Arch:           linux/amd64
     Experimental:      false
    
    Server: Docker Engine - Community
     Engine:
      Version:          19.03.12
      API version:      1.40 (minimum version 1.12)
      Go version:       go1.13.10
      Git commit:       48a66213fe
      Built:            Mon Jun 22 15:44:20 2020
      OS/Arch:          linux/amd64
      Experimental:     false
     containerd:
      Version:          1.2.13
      GitCommit:        7ad184331fa3e55e52b890ea95e65ba581ae3429
     runc:
      Version:          1.0.0-rc10
      GitCommit:        dc9208a3303feef5b3839f4323d9beb36df0a9dd
     docker-init:
      Version:          0.18.0
      GitCommit:        fec3683

I got the same error recently. It happens because you need to specify the version.

ie: docker pull envoyproxy/envoy:v1.18.3

If you try to do:

docker pull envoyproxy/envoy

You hit the following issue:

Error response from daemon: manifest for envoyproxy/envoy:latest not found: manifest unknown: manifest unknown

When you don't run the latest version of the docker image you need to mention the version starting with the ':' at the end of the image.

eg: repository-name/image-name:<version_number>

I had this happen after I deleted images from my private registry,because images I didn't delete depended on the ones I deleted. The registry was on my build server, so I had the source for the repo available in .../jenkins_home/workspace/MYPROJECT_projname_MYTAG. I went there and rebuilt the image with --no-cache so it would stop relying on deleted images, and pushed it to the registry.

IMAGE_NAME=my/image
TAG=PR-59
docker build . -t ${IMAGE_NAME}:${TAG}temp --no-cache
docker tag ${IMAGE_NAME}:${TAG}temp $REGISTRY_IP:$REGISTRY_PORT/${IMAGE_NAME}:${TAG}
docker push $REGISTRY_IP:$REGISTRY_PORT/${IMAGE_NAME}:${TAG}