tonistiigi/binfmt

Cross-platform emulator collection distributed with Docker images.

This image can be used to install emulators for architectures your node does not have native support so that you can run and build containers for any architecture.

Report issues at https://github.com/tonistiigi/binfmt

Latest release build

• https://github.com/tonistiigi/binfmt/blob/deploy/v10.0.4-56/Dockerfile https://github.com/tonistiigi/binfmt/blob/deploy/v10.0.4-56/Dockerfile

• https://github.com/tonistiigi/binfmt/blob/deploy/v9.2.2-52/Dockerfile

• https://github.com/tonistiigi/binfmt/blob/deploy/v8.1.5-45/Dockerfile

• https://github.com/tonistiigi/binfmt/blob/deploy/v7.0.0-29/Dockerfile

• https://github.com/tonistiigi/binfmt/blob/desktop/v10.0.4-56/Dockerfile https://github.com/tonistiigi/binfmt/blob/desktop/v9.2.0-49/Dockerfile Build with additional patches shipping in Docker Desktop

Deployed via https://github.com/tonistiigi/binfmt/actions/workflows/release.yml

Development build from master branch

• https://github.com/tonistiigi/binfmt/blob/master/Dockerfile

Usage

Installing emulators

All emulators:

bash
docker run --privileged --rm tonistiigi/binfmt --install all

Pick specific emulators:

docker run --privileged --rm tonistiigi/binfmt --install arm64,riscv64,arm

Show currently supported architectures and installed emulators

bash
docker run --privileged --rm myuser/binfmt

Prints output similar to

json
{
  "supported": [
    "linux/amd64",
    "linux/arm64",
    "linux/riscv64",
    "linux/ppc64le",
    "linux/s390x",
    "linux/386",
    "linux/arm/v7",
    "linux/arm/v6"
  ],
  "emulators": [
    "qemu-aarch64",
    "qemu-arm",
    "qemu-ppc64le",
    "qemu-riscv64",
    "qemu-s390x"
  ]
}

Uninstall emulator

docker run --privileged --rm tonistiigi/binfmt --uninstall qemu-aarch64

Github Action

In Github Actions environment you can use https://github.com/docker/setup-qemu-action to load this image.

yaml
      -
        name: Set up QEMU
        uses: docker/setup-qemu-action@v1

Supported architectures

• amd64
• arm64
• arm/v7
• s390x
• ppc64le
• riscv64
• 386