⚠ Partial

Docker Compose v2 on ARM64: Works; Images Must Support arm64 or Use Emulation

Docker Compose v2 + ARM64 (Apple Silicon / AWS Graviton)

Docker Compose v2 itself runs natively on ARM64. The issue is that images referenced in `compose.yml` must support `linux/arm64`, or they run via QEMU emulation at reduced speed. Add `platform: linux/arm64` to services in your Compose file to enforce the platform explicitly.

Required Flags / Config

platform: linux/arm64 (per service in compose.yml)

Workarounds & Fixes

In compose.yml: add `platform: linux/arm64` under each service
For amd64-only images: `platform: linux/amd64` to run via emulation
Enable Rosetta in Docker Desktop (macOS) for faster amd64 emulation

Related Error Pages

Fix: docker docker compose not found mac

Related Combinations

Docker Compose v2 + Docker Engine 20.10 ⚠ Partial Docker Compose v2 + Docker Engine 23.0+ ✓ Works Docker Compose v2 + Ubuntu 22.04 LTS ✓ Works Docker Compose v2 + Ubuntu 24.04 LTS ✓ Works

Last verified: 2024-10-01 · Category: Docker Compose + Engine