ProjectStack
docker

no matching manifest for linux/arm64/v8 in the manifest list entries

The image you're trying to pull doesn't have a build for your CPU architecture. This is very common on Apple Silicon Macs (M1/M2/M3) because older or less-maintained images only have AMD64 (x86_64) builds, not ARM64 builds.

Common causes

  • Running Docker on an Apple Silicon Mac (M1/M2/M3) and pulling an AMD64-only image
  • The image doesn't publish multi-architecture builds for your platform
  • A self-built image was built on AMD64 but you're running on ARM64 or vice versa
  • The platform field in docker-compose.yml or the image's Dockerfile targets a specific arch

How to fix it

  1. Force Docker to use an AMD64 image with emulation: docker pull --platform linux/amd64 image:tag
  2. In docker run: docker run --platform linux/amd64 image:tag
  3. In Docker Compose: add platform: linux/amd64 under the service definition
  4. For your own images, build multi-arch with buildx: docker buildx build --platform linux/amd64,linux/arm64 -t myimage:tag --push .

Example

$ docker pull oldimage:latest Unable to find image 'oldimage:latest' locally no matching manifest for linux/arm64/v8 in the manifest list entries

Pulling an AMD64-only image on an Apple Silicon Mac without specifying the platform

Related Docker Errors

Cannot connect to Docker daemonPermission denied connecting to Docker socketDocker daemon not running on this hostImage not found or pull access deniedImage manifest not found (tag doesn't exist)

Browse more errors

The Developer Hub covers 150+ errors across Git, npm, Node.js, Python, TypeScript, and Docker — with plain-English explanations and fix steps.