The current wording is a little misleading on QEMU and binfmt_misc. This is a problem Ubuntu and, maybe, other distributions. > For QEMU binaries registered with `binfmt_misc` on the host OS to work transparently inside containers they must be registered with the `fix_binary` flag. This requires a kernel >= 4.8 and binfmt-support >= 2.1.7. You can check for proper registration by checking if `F` is among the flags in `/proc/sys/fs/binfmt_misc/qemu-*`. This implies that setting the fix_binary flag on otherwise installed QEMU & binfmt_msc will work; it probably wont. Eg installing Ubuntu packages `qemu-user` `qemu-user-binfmt` will install dynamically linked QEMU and binfmt_msc entries without the `F` flag. Manually adding `F` to the flags will break because `F` (fix_binary) is incompatible with dynamically linked binaries. (Referenced in [this Redhat issue](https://bugzilla.redhat.com/show_bug.cgi?id=1470397)) It actually results in really hard to diagnose "No such file or directory" errors. Instead you must install the ubuntu package `qemu-user-static`. Obviously this page can't document every distribution so I'm not going to recommend describing how to do it under Ubuntu. My suggestion is to simply state that QEMU must be statically compiled. At least this gives readers a chance to figure it out. |
||
---|---|---|
.docker | ||
.github | ||
_data | ||
_deploy/nginx | ||
_includes | ||
_layouts | ||
_plugins | ||
_samples/library | ||
_scripts | ||
_scss | ||
buildx | ||
ci-cd | ||
cloud | ||
compose | ||
config | ||
css | ||
datacenter | ||
desktop | ||
develop | ||
docker-hub | ||
docker-id | ||
ee | ||
engine | ||
favicons | ||
fonts | ||
get-started | ||
go | ||
images | ||
js | ||
kitematic | ||
language | ||
machine | ||
network | ||
opensource | ||
reference | ||
registry | ||
release-notes | ||
samples | ||
security | ||
single-sign-on | ||
storage | ||
subscription | ||
tests | ||
toolbox | ||
.dockerignore | ||
.editorconfig | ||
.env | ||
.eslintignore | ||
.gitattributes | ||
.gitignore | ||
.gitmodules | ||
.markdownlint.json | ||
.nojekyll | ||
.prettierignore | ||
.ruby-version | ||
404.html | ||
404.md | ||
CONTRIBUTING.md | ||
Dockerfile | ||
Gemfile | ||
LICENSE | ||
Makefile | ||
README.md | ||
_config.yml | ||
_config_production.yml | ||
_website-config-docs-stage.json | ||
_website-config-docs.json | ||
components.md | ||
docker-compose.yml | ||
docsarchive.md | ||
favicon.ico | ||
get-docker.md | ||
glossary.md | ||
google161104f9fdea6089.html | ||
googlecbe7fee896be512c.html | ||
index.html | ||
index.md | ||
robots.txt | ||
search.md | ||
test.md |
README.md
Docs @ Docker

Welcome to the Docker Documentation repository. This is the source for https://docs.docker.com/.
Feel free to send us pull requests and file issues. Our docs are completely open source and we deeply appreciate contributions from the Docker community!
Provide feedback
We’d love to hear your feedback. Please file documentation issues only in the docs GitHub repository. You can file a new issue to suggest improvements or if you see any errors in the existing documentation.
Before submitting a new issue, check whether the issue has already been reported. You can join the discussion using an emoji, or by adding a comment to an existing issue. If possible, we recommend that you suggest a fix to the issue by creating a pull request.
You can ask general questions and get community support through the Docker Community Slack. Personalized support is available through the Docker Pro, Team, and Business subscriptions. See Docker Pricing for details.
If you have an idea for a new feature or behavior change in a specific aspect of Docker, or have found a product bug, file that issue in the project's code repository.
We've made it really easy for you to file new issues.
- Click New issue on the docs repository and fill in the details, or
- Click Request docs changes in the right column of every page on docs.docker.com and add the details.
Contribute to Docker docs
We value your contribution. We'd like to make it as easy as possible to submit
your contributions to the Docker docs repository. Changes to the docs are
handled through pull requests against the master
branch. To learn how to
contribute, see CONTRIBUTING.md.
Copyright and license
Copyright 2013-2021 Docker, inc, released under the Apache 2.0 license.