Docker on Apple Silicon: 'WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested' - what should I do?

Cause: the image you pulled only has a linux/amd64 (x86-64) variant, but your Mac's CPU is arm64. Containers share the host kernel, so code built for a different architecture only runs under emulation. Docker can still run it with emulation, which is why this is a warning, but it is slower and some programs (especially JIT or heavy database workloads) crash or behave oddly. Fix (best first): 1. Prefer a native arm64 image: check whether the project publishes a multi-platform tag or an arm64 variant, or a newer version that does. Docker automatically picks the variant matching your host when the image is multi-platform. 2. If you build the image yourself, build for both: docker buildx build --platform linux/amd64,linux/arm64 -t <name> --push . (multi-platform builds need an image store or builder that supports manifest lists; with the classic store use a docker-container builder and push). Fix any base image or downloaded binary in your Dockerfile that is hardcoded to x86-64. 3. If you must run the amd64 image, say so explicitly to silence the warning and be clear what you are doing: docker run --platform linux/amd64 <image>, or platform: linux/amd64 on a Compose service. 4. In Docker Desktop on Mac, the setting 'Use Rosetta for x86_64/amd64 emulation' (General, disabled by default, requires the Apple Virtualization framework VMM) can speed up amd64 emulation compared with QEMU. 5. If emulation fails on Linux (exec format error), install the QEMU binfmt handlers as documented by Docker, which needs a privileged helper container; only do this on machines you control. Verify: docker image inspect --format '{{.Os}}/{{.Architecture}}' <image> shows linux/arm64 for a native run, or the amd64 container starts and runs correctly under the explicit platform flag. Sources: https://docs.docker.com/build/building/multi-platform/ https://docs.docker.com/desktop/settings-and-maintenance/settings/ https://docs.docker.com/reference/cli/docker/image/pull/