docker/setup-qemu-action@v4
Install QEMU static binaries
At a glance
- Latest major
v4- Repository
- docker/setup-qemu-action
- Inputs
- 4 (0 required)
- Outputs
- 1
- Runs using
node24- License
- Apache-2.0
- Last checked
Inputs and outputs come straight from the action's official action.yml. See our editorial standards.
Usage
- uses: docker/setup-qemu-action@v4Inputs
| Name | Required | Default | Description |
|---|---|---|---|
image | No | docker.io/tonistiigi/binfmt:latest | QEMU static binaries Docker image (e.g. tonistiigi/binfmt:latest) |
platforms | No | all | Platforms to install (e.g. arm64,riscv64,arm) |
reset | No | false | Uninstall current emulators before installation |
cache-image | No | true | Cache binfmt image to GitHub Actions cache backend |
Outputs
| Name | Description |
|---|---|
platforms | Available platforms (comma separated) |
Read an output with ${{ steps.<step-id>.outputs.<name> }}; the step needs an id.
Examples
Emulate arm64 on an x86 runner
Needed to build `linux/arm64` images on a standard runner.
name: Example
on:
push:
branches: [main]
permissions:
contents: read
jobs:
example:
runs-on: ubuntu-latest
steps:
- name: Docker Setup QEMU
uses: docker/setup-qemu-action@v4
with:
platforms: arm64Each example passed actionlint (syntax, expressions and the inputs it knows for this action). They were not run in a live repository, so replace placeholder values such as names, ARNs and paths with your own.
Something out of date or wrong? Report it on our Contact page. This page is rebuilt from the action's repository roughly once a week.