Skip to content

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

Open
lacatoire wants to merge 1 commit intodocker:mainfrom
lacatoire:fix/issue-22899-buildkit-builtin-qemu
Open

docs: note BuildKit ships QEMU emulators for multi-platform builds#24750
lacatoire wants to merge 1 commit intodocker:mainfrom
lacatoire:fix/issue-22899-buildkit-builtin-qemu

Conversation

@lacatoire
Copy link
Copy Markdown
Contributor

Fixes #22899.

The Prerequisites paragraph on docs.docker.com/build/building/multi-platform/ tells Docker Engine standalone users they "also need to install QEMU" to build multi-platform images with emulation, but official BuildKit releases already bundle QEMU user-mode emulators (upstream doc : "You do not need to set up QEMU manually in most cases").

Reword the Prerequisites pointer and the Install QEMU manually intro so the manual install is presented as a fallback (for example, with a third-party BuildKit package that doesn't ship the bundled emulators) rather than a default step.

…ilds

BuildKit ships QEMU user-mode emulators in official releases, so a
manual QEMU install is a fallback rather than a default prerequisite for
Docker Engine standalone. Reword the Prerequisites pointer and the
Install QEMU manually intro accordingly.

Closes docker#22899
@lacatoire lacatoire requested a review from dvdksn as a code owner April 16, 2026 16:28
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 16, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit b5690de
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69e10e3abe43f8000877635a
😎 Deploy Preview https://deploy-preview-24750--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

@dvdksn dvdksn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM thanks

@dvdksn dvdksn requested a review from tonistiigi April 17, 2026 07:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Please update multi-platform to mention that the official buildkit will do non-native emulation via QEMU

2 participants