Skip to content

docs: note binfmt/QEMU requirement for docker run --platform - #7158

Open
locker95 wants to merge 1 commit into
docker:masterfrom
locker95:docs/platform-binfmt-note-3701
Open

docs: note binfmt/QEMU requirement for docker run --platform#7158
locker95 wants to merge 1 commit into
docker:masterfrom
locker95:docs/platform-binfmt-note-3701

Conversation

@locker95

@locker95 locker95 commented Aug 6, 2026

Copy link
Copy Markdown

On a stock Linux Engine, `docker run --platform linux/arm64 …` can pull fine and then die with exec format error if binfmt/QEMU isn't installed. Desktop hides that.

Added a short --platform section that calls that out.

Fixes #3701

--platform can pull a foreign arch image and still fail with exec format
error on Linux Engine if qemu-user binfmt handlers are missing.

Fixes docker#3701

Signed-off-by: Dean Chen <862469039@qq.com>
@locker95
locker95 requested review from a team and thaJeztah as code owners August 6, 2026 12:46
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.

binfmt setup not mentioned outside of Docker Desktop docs

1 participant