Docker Error Code Exec Format Error: How to Fix It

Q: Why do I get exec format error on Apple Silicon Mac?

Apple Silicon Macs use ARM64 architecture, but many Docker images are built for AMD64/x86_64. You need to either pull ARM64 versions of images or enable emulation to run AMD64 images.

Q: Can I run AMD64 Docker images on ARM64 systems?

Yes, but you need QEMU emulation enabled. Install it with 'docker run --privileged --rm tonistiigi/binfmt --install all'. Performance will be slower than native ARM64 images.

Q: How do I build Docker images that work on both AMD64 and ARM64?

Use Docker Buildx to create multi-architecture images: 'docker buildx build --platform linux/amd64,linux/arm64 -t your-image .' This builds a single image that works on both architectures.

Q: What's the difference between linux/amd64 and linux/arm64?

linux/amd64 is for Intel/AMD x86_64 processors (most PCs and servers), while linux/arm64 is for ARM 64-bit processors (Apple Silicon Macs, ARM servers, Raspberry Pi 4+).

Q: How do I check what architecture a Docker image supports?

Use 'docker manifest inspect [image_name]' to see all available architectures for an image, or 'docker image inspect [image_name]' to check the architecture of a locally pulled image.

Abstract

The Docker exec format error occurs when you try to run a container image that was built for a different CPU architecture than your host system. This commonly happens when running amd64 (x86_64) images on arm64 systems like Apple Silicon Macs or ARM-based servers.