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@v4

Inputs

NameRequiredDefaultDescription
imageNodocker.io/tonistiigi/binfmt:latestQEMU static binaries Docker image (e.g. tonistiigi/binfmt:latest)
platformsNoallPlatforms to install (e.g. arm64,riscv64,arm)
resetNofalseUninstall current emulators before installation
cache-imageNotrueCache binfmt image to GitHub Actions cache backend

Outputs

NameDescription
platformsAvailable 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: arm64

Each 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.