tonistiigi/binfmt repository overview

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

• latest⁠ qemu-v10.0.4⁠

• qemu-v9.2.2⁠

• qemu-v8.1.5⁠

• qemu-v7.0.0⁠

• desktop-v10.0.4⁠ desktop-v9.2.0⁠ Build with additional patches shipping in Docker Desktop

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

⁠Development build from master branch

• master⁠

⁠Usage

⁠Installing emulators

All emulators:

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

docker run --privileged --rm myuser/binfmt

Prints output similar to

{
  "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 setup-qemu-action⁠ to load this image.

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

⁠Supported architectures

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