Skip to content

Commit 62aae99

Browse files
committed
build: clarify that QEMU setup is only for non-desktop users
Signed-off-by: David Karlsson <[email protected]>
1 parent b095293 commit 62aae99

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

content/build/building/multi-platform.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,19 @@ loads it through a binary registered in the `binfmt_misc` handler.
6161
> Use [multiple native nodes](#multiple-native-nodes) or
6262
> [cross-compilation](#cross-compilation) instead, if possible.
6363
64+
## Support on Docker Desktop
65+
66+
[Docker Desktop](../../desktop/index.md) provides `binfmt_misc`
67+
multi-architecture support, which means you can run containers for different
68+
Linux architectures such as `arm`, `mips`, `ppc64le`, and even `s390x`.
69+
70+
This doesn't require any special configuration in the container itself as it
71+
uses [qemu-static](https://wiki.qemu.org/Main_Page)
72+
from the Docker Desktop VM. Because of this, you can run an ARM container,
73+
like the `arm32v7` or `ppc64le` variants of the busybox image.
74+
75+
#### QEMU without Docker Desktop
76+
6477
For QEMU binaries registered with `binfmt_misc` on the host OS to work
6578
transparently inside containers, they must be statically compiled and
6679
registered with the `fix_binary` flag. This requires a kernel version 4.8 or
@@ -266,14 +279,3 @@ armv7l
266279

267280
In the above example, `uname -m` returns `aarch64` and `armv7l` as expected,
268281
even when running the commands on a native macOS or Windows developer machine.
269-
270-
## Support on Docker Desktop
271-
272-
[Docker Desktop](../../desktop/index.md) provides `binfmt_misc`
273-
multi-architecture support, which means you can run containers for different
274-
Linux architectures such as `arm`, `mips`, `ppc64le`, and even `s390x`.
275-
276-
This does not require any special configuration in the container itself as it
277-
uses [qemu-static](https://wiki.qemu.org/Main_Page)
278-
from the Docker Desktop VM. Because of this, you can run an ARM container,
279-
like the `arm32v7` or `ppc64le` variants of the busybox image.

0 commit comments

Comments
 (0)