Building for ARM64 (macOS)¶
The Mac images are built for linux/arm64 using Docker buildx with QEMU emulation. You must create a persistent builder before building locally.
Setup¶
# Create a builder using the docker-container driver
docker buildx create --name mybuilder --driver docker-container --use
# Verify arm64 is listed under platforms
docker buildx inspect --bootstrap
Then build with:
Troubleshooting¶
If a build fails with QEMU errors, reset the emulator registration and recreate the builder: