How to fix ERROR: multiple platforms feature is currently not supported for docker driver in Docker

Create a new buildx builder that uses the docker-container driver, which supports multi-platform builds:

docker buildx create --name multiplatform-builder --driver docker-container --bootstrap --use

This command:
- Creates a new builder named multiplatform-builder
- Uses the docker-container driver (runs BuildKit in a container)
- --bootstrap starts the builder immediately
- --use sets it as the current builder

You should see output indicating the builder was created and started.

Confirm your new builder is set up and running:

docker buildx inspect --bootstrap

Look for output showing:
- Driver: docker-container
- Status: running
- Platforms: multiple platforms listed (linux/amd64, linux/arm64, etc.)

You can also list all builders:

docker buildx ls

The active builder will have an asterisk (*) next to its name.

Now you can build for multiple platforms. Note that multi-platform images must be pushed to a registry (you cannot load them into your local Docker image store):

docker buildx build --platform linux/amd64,linux/arm64 -t yourusername/yourimage:tag --push .

If you want to load a single-platform image locally instead:

docker buildx build --platform linux/amd64 -t yourimage:tag --load .

The --push flag is required for multi-platform builds because Docker's local image store doesn't support multi-architecture manifest lists.

If you're building for a platform different from your host (e.g., ARM on x86_64), you may need QEMU user-space emulation:

docker run --rm --privileged multiarch/qemu-user-static --reset -p yes

This registers QEMU binary handlers with the kernel, enabling your system to run binaries for other architectures. After running this, restart your builder:

docker buildx rm multiplatform-builder
docker buildx create --name multiplatform-builder --driver docker-container --bootstrap --use

Docker Desktop users typically have QEMU already configured.

If you're using Docker Desktop, you can alternatively enable the containerd image store, which adds multi-platform support to the default driver:

1. Open Docker Desktop
2. Go to Settings (gear icon)
3. Navigate to Features in development (or General in newer versions)
4. Enable "Use containerd for pulling and storing images"
5. Click Apply & Restart

After enabling, you may be able to use multi-platform builds with the default driver. However, creating a dedicated docker-container builder is still recommended for more flexibility and consistent behavior across environments.