Fix docker command examples in "Getting started" in README #216
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Without the --platform option, docker fails with "docker: no matching manifest for linux/amd64 in the manifest list entries". With the option, eveything works as intended.
Alestrix
reviewed
Dec 4, 2025
| $ docker run --rm --privileged multiarch/qemu-user-static --reset -p yes | ||
| $ docker run --rm -t arm64v8/ubuntu uname -m | ||
| $ docker run --rm -t --platform linux/arm64v8 arm64v8/ubuntu uname -m |
There was a problem hiding this comment.
This doesn't work either:
$ docker run --rm -t --platform linux/arm64v8 arm64v8/ubuntu uname -m
Unable to find image 'arm64v8/ubuntu:latest' locally
latest: Pulling from arm64v8/ubuntu
docker: no matching manifest for linux/arm64v8 in the manifest list entries.
See 'docker run --help'.
After changing the --platform to just arm64 it "works" as intended:
$ docker run --rm -t --platform linux/arm64 arm64v8/ubuntu uname -m
Unable to find image 'arm64v8/ubuntu:latest' locally
latest: Pulling from arm64v8/ubuntu
97dd3f0ce510: Pull complete
Digest: sha256:6ef519d3df37418310d265d26fa804357ff50c9e721e9b90823ff294938023d8
Status: Downloaded newer image for arm64v8/ubuntu:latest
exec /usr/bin/uname: exec format error
There was a problem hiding this comment.
Suggested change
| $ docker run --rm -t --platform linux/arm64v8 arm64v8/ubuntu uname -m | |
| $ docker run --rm -t --platform linux/arm64 arm64v8/ubuntu uname -m |
Alestrix
reviewed
Dec 4, 2025
|
|
||
| ``` | ||
| $ docker run --rm -t arm32v6/alpine uname -m | ||
| $ docker run --rm -t --platform linux/arm32v6 arm32v6/alpine uname -m |
There was a problem hiding this comment.
same as above:
$ docker run --rm -t --platform linux/arm32v6 arm32v6/alpine uname -m
Unable to find image 'arm32v6/alpine:latest' locally
latest: Pulling from arm32v6/alpine
docker: no matching manifest for linux/arm32v6 in the manifest list entries.
See 'docker run --help'.
$ docker run --rm -t --platform linux/arm arm32v6/alpine uname -m
Unable to find image 'arm32v6/alpine:latest' locally
latest: Pulling from arm32v6/alpine
dd0740468c9e: Pull complete
Digest: sha256:e86713155975b687d8ee532b1580704c4d06e46349d43f915e237d0d1392b5f9
Status: Downloaded newer image for arm32v6/alpine:latest
exec /bin/uname: exec format error
There was a problem hiding this comment.
Suggested change
| $ docker run --rm -t --platform linux/arm32v6 arm32v6/alpine uname -m | |
| $ docker run --rm -t --platform linux/arm arm32v6/alpine uname -m |
Alestrix
reviewed
Dec 4, 2025
| s390x | ||
| $ docker run --rm -t arm64v8/fedora uname -m | ||
| $ docker run --rm -t --platform linux/arm64v8 arm64v8/fedora uname -m |
There was a problem hiding this comment.
Suggested change
| $ docker run --rm -t --platform linux/arm64v8 arm64v8/fedora uname -m | |
| $ docker run --rm -t --platform linux/arm64 arm64v8/fedora uname -m |
Alestrix
reviewed
Dec 4, 2025
| aarch64 | ||
| $ docker run --rm -t arm32v7/centos uname -m | ||
| $ docker run --rm -t --platform linux/arm32v7 arm32v7/centos uname -m |
There was a problem hiding this comment.
Suggested change
| $ docker run --rm -t --platform linux/arm32v7 arm32v7/centos uname -m | |
| $ docker run --rm -t --platform linux/arm arm32v7/centos uname -m |
Alestrix
suggested changes
Dec 4, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This fixes issue 215
Without the
--platformoption, docker fails with"docker: no matching manifest for linux/amd64 in the manifest list entries".
With the option, everything works as intended.