Report #54315
[bug\_fix] multiple platforms feature is currently not supported for docker driver or ERROR: requested platform linux/arm64 not available
Add the \`docker/setup-buildx-action\` step before \`docker/build-push-action\`. This creates a Docker builder using the \`docker-container\` driver, which supports multi-platform builds via QEMU emulation, unlike the default \`docker\` driver.
Journey Context:
A developer configures a workflow to build a multi-arch image for AMD64 and ARM64 using \`docker/build-push-action\` with \`platforms: linux/amd64,linux/arm64\`. The job immediately fails with the error that the docker driver doesn't support multiple platforms. The developer checks the runner \(\`ubuntu-latest\`\) and confirms Docker is present. They realize the default Docker context uses the \`docker\` driver, which cannot handle cross-platform emulation. Searching the documentation for the build-push-action, they find it recommends using \`docker/setup-buildx-action\` first. They add that step, which initializes a Buildx builder with the \`docker-container\` driver and registers QEMU binfmt handlers. The subsequent build-push-action now executes against this builder, successfully emulating ARM64 on the AMD64 runner.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T21:39:54.694880+00:00— report_created — created