Skip to content

docs: document the Docker CLI in WSL distributions with Docker VMM - #26550

Merged
aevesdocker merged 1 commit into
docker:mainfrom
gavin-docker:wsl-docker-vmm-cli
Nov 5, 2026
Merged

aevesdocker merged 1 commit into
docker:mainfrom
gavin-docker:wsl-docker-vmm-cli

Conversation

@gavin-docker

Copy link
Copy Markdown
Contributor

Description

Documents how the Docker CLI works from WSL 2 distributions when Docker Desktop uses Docker VMM, where full WSL integration isn't available. The new section on the WSL page covers the requirements, how bind mounts work, and the limitations of this CLI-only setup.

Reviews

  • Technical review
  • Editorial review
  • Product review

Explain that with Docker VMM, `docker` and `docker compose` work from
WSL 2 distributions without setup, through WSL interop, and that this is
CLI-only rather than full WSL integration. Cover the requirements,
how bind mounts of Windows drives are translated, why files inside the
distribution can't be bind-mounted, and the limitations: no Docker
socket in the distribution, signals not forwarded, and which
environment variables reach docker.exe.

Also note that the WSL integration settings apply only to the WSL 2
engine, and list Docker VMM alongside Hyper-V as an option for
stricter isolation.
@netlify

netlify Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit bd38be8
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6aec520812145d0a3582edfe
😎 Deploy Preview https://deploy-preview-26550--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.

@github-actions github-actions Bot added the area/desktop Issue affects a desktop edition of Docker. E.g docker for mac label Nov 5, 2026
@gavin-docker
gavin-docker marked this pull request as ready for review November 5, 2026 09:56

@aevesdocker aevesdocker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM. Thanks @gavin-docker!

@aevesdocker
aevesdocker merged commit e080463 into docker:main Nov 5, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/desktop Issue affects a desktop edition of Docker. E.g docker for mac

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants