Awesome
meedamian/simple-qemu
This project aims to make cross-compilation, and running programs and images built for a different CPU architecture simple.
Currently, the only host architecture supported is amd64
(AKA x86_64
), while the architectures that can be emulated are:
i386
(AKAx86
,i686
)arm
(AKAarm32v7
)aarch64
(AKAarm64v8
,arm64
)riscv32
riscv64
Image categories
There are 3 distinct categories of images below:
- An image containing binaries for all architectures. Tagged with a version alone, ex:
:v5.1.0
, or:latest
. - An enable-emulation-only image. It contains no
qemu
binaries, but can be used to enable emulation for use with your ownqemu
binary. Tagged with the keywordenable
, ex::v5.1.0-enable
, or:enable
. - A single-architecture image. These images contain a single architecture plus a script to enable emulation. Tagged with the name of the architecture, ex:
v5.1.0-arm
, oraarch64
.
Simple tags
For a complete list of available tags see: r/meedamian/simple-qemu/tags
v5.1.0
v5.1.0
,v5.1
,v5
,latest
v5.1.0-arm
,v5.1-arm
,v5-arm
,arm
(or:arm32v7
)v5.1.0-aarch64
,v5.1-aarch64
,v5-aarch64
,aarch64
(or:arm64v8
&arm64
)v5.1.0-riscv32
,v5.1-riscv32
,v5-riscv32
,riscv32
v5.1.0-riscv64
,v5.1-riscv64
,v5-riscv64
,riscv64
v5.1.0-enable
,v5.1-enable
,v5-enable
,enable
v5.0.1
v5.0.1
,v5.0
v5.0.1-arm
,v5.0-arm
(or:-arm32v7
)v5.0.1-aarch64
,v5.0-aarch64
(or:-arm64v8
&-arm64
)v5.0.1-riscv32
,v5.0-riscv32
v5.0.1-riscv64
,v5.0-riscv64
v5.0.1-enable
,v5.0-enable
v4.2.1
v4.2.1
,v4.2
,v4
v4.2.1-arm
,v4.2-arm
,v4-arm
(or:-arm32v7
)v4.2.1-aarch64
,v4.2-aarch64
,v4-aarch64
(or:-arm64v8
&-arm64
)v4.2.1-riscv32
,v4.2-riscv32
,v4-riscv32
v4.2.1-riscv64
,v4.2-riscv64
,v4-riscv64
v4.2.1-enable
,v4.2-enable
,v4-enable
v4.1.1
v4.1.1
,v4.1
v4.1.1-arm
,v4.1-arm
(or:-arm32v7
)v4.1.1-aarch64
,v4.1-aarch64
(or:-arm64v8
&-arm64
)v4.1.1-riscv32
,v4.1-riscv32
v4.1.1-riscv64
,v4.1-riscv64
v4.1.1-enable
,v4.1-enable
v4.0.1
v4.0.1
,v4.0
v4.0.1-arm
,v4.0-arm
(or:-arm32v7
)v4.0.1-aarch64
,v4.0-aarch64
(or:-arm64v8
&-arm64
)v4.0.1-riscv32
,v4.0-riscv32
v4.0.1-riscv64
,v4.0-riscv64
v4.0.1-enable
,v4.0-enable
v3.1.1
v3.1.1
,v3.1
,v3
v3.1.1-arm
,v3.1-arm
,v3-arm
(or:-arm32v7
)v3.1.1-aarch64
,v3.1-aarch64
,v3-aarch64
(or:-arm64v8
&-arm64
)v3.1.1-riscv32
,v3.1-riscv32
,v3-riscv32
v3.1.1-riscv64
,v3.1-riscv64
,v3-riscv64
v3.1.1-enable
,v3.1-enable
,v3-enable
v5.0.0
v5.0.0
v5.0.0-arm
(or:-arm32v7
)v5.0.0-aarch64
(or:-arm64v8
&-arm64
)v5.0.0-riscv32
v5.0.0-riscv64
v5.0.0-enable
v4.2.0
v4.2.0
v4.2.0-arm
(or:-arm32v7
)v4.2.0-aarch64
(or:-arm64v8
&-arm64
)v4.2.0-riscv32
v4.2.0-riscv64
v4.2.0-enable
v4.1.0
v4.1.0
v4.1.0-arm
(or:-arm32v7
)v4.1.0-aarch64
(or:-arm64v8
&-arm64
)v4.1.0-riscv32
v4.1.0-riscv64
v4.1.0-enable
v4.0.0
v4.0.0
v4.0.0-arm
(or:-arm32v7
)v4.0.0-aarch64
(or:-arm64v8
&-arm64
)v4.0.0-riscv32
v4.0.0-riscv64
v4.0.0-enable
v3.1.0
v3.1.0
v3.1.0-arm
(or:-arm32v7
)v3.1.0-aarch64
(or:-arm64v8
&-arm64
)v3.1.0-riscv32
v3.1.0-riscv64
v3.1.0-enable
Usage
First, enabling emulation needs to be coordinated with host's kernel:
docker run --rm --privileged meedamian/simple-qemu -p yes
Once that's done, two things become possible:
Running
To run image built for a different CPU architecture:
docker run --rm arm32v7/alpine uname -m
Alternatively (buildx
style):
docker run --rm --platform=linux/arm/v7 alpine uname -m
Extending
To build FROM
different CPU architecture image:
FROM arm32v7/alpine
# Everything written here will be run on an emulated architecture
Alternatively (buildx
style):
FROM --platform=linux/arm/v7 alpine
# Everything written here will be run on an emulated architecture
It's that simple :).
Note: To learn what architectures are available for the given base image you can use
docker manifest inspect
command, for example:$ docker manifest inspect alpine | jq -r '.manifests[].platform | .os + "/" + .architecture + "/" + .variant' linux/amd64 linux/arm/v6 linux/arm/v7 linux/arm64/v8 linux/386 linux/ppc64le linux/s390x
Performance
Depending on qemu
version used, the speed of emulation can vary from hardly bearable all the way to nightmarishly slow.
For daily generated speed comparisons see: https://github.com/lncm/docker-bitcoind/issues/9
Bugs and feedback
If you discover a bug please report it here. Express gratitude here.
Mail me at bugs@meedamian.com, or on twitter @meeDamian.
License
MIT @ Damian Mee