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>