Error pulling image : no matching manifest

Article ID: KB000721

Issue

When you pull an image, you might receive this error message:

no matching manifest for [...] in the manifest list entries 

Prerequisites

Root Cause

You are trying to download an image not available for your system (OS or Architecture).

Resolution

If you see the error message no matching manifest for [...] in the manifest list entries, follow these steps:

  1. Find the OS/Arch of you system:

    docker info  -f '{{.OSType}}/{{.Architecture}}'
    

    For example,

    linux/x86_64
    
  2. Find the OS/Arch of the image you want to download:

    docker manifest inspect -v library/tomcat:latest | jq .[].Platform
    

    For example:

    > { "architecture": "amd64", "os": "linux" } { "architecture": "arm", "os": "linux", "variant": "v5" } { "architecture": "arm", "os": "linux", "variant": "v7" } { "architecture": "arm64", "os": "linux", "variant": "v8" } { "architecture": "386", "os": "linux" } { "architecture": "ppc64le", "os": "linux" } { "architecture": "s390x", "os": "linux" }

  3. If you cannot find the image, check if you are not pulling from :latest. You might not be if the latest build for your system is not ready yet.