Skip to content

docs: note BuildKit ships QEMU emulators for multi-platform builds #24750

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: main
Choose a base branch
from
+9 −6
Open

docs: note BuildKit ships QEMU emulators for multi-platform builds #24750

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions content/manuals/build/building/multi-platform.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,8 +89,11 @@ $ docker buildx create \
> drivers](/manuals/build/builders/drivers/_index.md).

If you're using Docker Engine standalone and you need to build multi-platform
images using emulation, you also need to install QEMU, see [Install QEMU
manually](#install-qemu-manually).
images using emulation, official BuildKit releases bundle QEMU user-mode
emulators, so in most cases you don't need to install QEMU manually. See
[Install QEMU manually](#install-qemu-manually) if emulation fails, for
example with a third-party BuildKit package that doesn't ship the bundled
emulators.

## Build multi-platform images

Expand Down Expand Up @@ -131,10 +134,10 @@ QEMU that's bundled within the Docker Desktop VM.

#### Install QEMU manually

If you're using a builder outside of Docker Desktop, such as if you're using
Docker Engine on Linux, or a custom remote builder, you need to install QEMU
and register the executable types on the host OS. The prerequisites for
installing QEMU are:
If the QEMU emulators bundled with BuildKit don't work for your build, for
example with a third-party BuildKit package that doesn't ship them, you can
install QEMU and register the executable types on the host OS. The
prerequisites for installing QEMU are:

- Linux kernel version 4.8 or later
- `binfmt-support` version 2.1.7 or later
Expand Down