Build multi-architecture images with GitHub Arm-hosted runners
Introduction
Build options for multi-architecture container images
Arm-hosted runners for public repositories
Create a new Arm-hosted runner for private repositories
Run GitHub Actions jobs on the Arm-hosted runner
Next Steps
Build multi-architecture images with GitHub Arm-hosted runners
Review frequently asked questions
These FAQs were drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.
Check the Actions run details for the runner name or labels that indicate an Arm architecture and confirm the workflow selects the Arm-hosted runner. If the run shows a different runner, review the
runs-on setting in the workflow.Confirm the account uses a Team or Enterprise Cloud plan because private repositories require it for Arm-hosted runners. If it still doesn’t appear, review the repository or organization runner settings.
The path explains emulation and manifest-based builds, then uses Arm-hosted runners to perform native arm64 builds and assemble a multi-architecture image. The workflow relies on native Arm execution rather than instruction emulation for the arm64 build.
Add the required registry credentials as repository secrets and reference them in the workflow. Without these secrets, the push step fails to authenticate.
Expect a successful Actions run and a new image tag on Docker Hub with a multi-architecture manifest listing arm64 and amd64. If the platforms are missing, review the build logs to see which architecture jobs ran and which images were pushed.