Skip to content

docs: clarify WSL version requirements for ECI and Docker Desktop - #26259

Open
dave123981 wants to merge 1 commit into
docker:mainfrom
dave123981:fix/clarify-wsl-version-requirements
Open

dave123981 wants to merge 1 commit into
docker:mainfrom
dave123981:fix/clarify-wsl-version-requirements

Conversation

@dave123981

@dave123981 dave123981 commented Oct 3, 2026 •

Copy link
Copy Markdown

Fixes #26258

Description

This PR clarifies the WSL version requirements for Docker Desktop and Enhanced Container Isolation (ECI) to avoid user confusion.

The documentation previously implied that WSL 2.6+ was the general minimum requirement for Docker Desktop, even though Docker Desktop itself can run on WSL 2.1.5+. The ECI requirement is stricter:

  • Docker Desktop works with WSL 2.1.5 or later
  • Enhanced Container Isolation on the WSL 2 backend requires WSL 2.6 or later
  • Users on WSL 2.1.5-2.5 can use Docker Desktop, but cannot enable ECI

This updates the relevant documentation to clearly distinguish between:

  • the general Docker Desktop requirement
  • the ECI-specific requirement
  • the effect on users on older WSL versions

Updated files

  • content/manuals/desktop/enterprise/hardened-desktop/enhanced-container-isolation/_index.md
  • content/manuals/desktop/enterprise/hardened-desktop/enhanced-container-isolation/limitations.md

Why this change

The previous wording could cause readers to think WSL 2.6+ was required for Docker Desktop itself, rather than only for ECI. This update makes the requirements explicit and consistent across both pages.

Reviews

  • Technical review
  • Editorial review
  • Product review

- Specify that Docker Desktop works with WSL 2.1.5+ while ECI requires 2.6+
- Clarify that users with WSL 2.1.5-2.5 can run Docker Desktop but not ECI
- Ensure consistent messaging across _index.md and limitations.md
- Resolve conflicting information about minimum WSL versions

This addresses the confusion where the _index.md page didn't mention the
lower Docker Desktop baseline, potentially misleading users into thinking
WSL 2.6+ was required for Docker Desktop itself rather than just ECI.

Fixes docker#26258
@netlify

netlify Bot commented Oct 3, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 8c47dd9
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ac0b45cdd15d30008e1fbe3
😎 Deploy Preview https://deploy-preview-26259--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 Oct 3, 2026

This branch has not been deployed

No deployments
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.

[docs-scanner] Conflicting WSL version requirements between ECI pages

1 participant