Skip to content

Conversation

@djs55
Copy link
Contributor

@djs55 djs55 commented May 15, 2025

Description

Improve the troubleshooting docs for Desktop, inspired by tickets like docker/for-win#14743

The troubleshooting contains the relevant info, but this PR

  • explicitly mentions a common error code (hopefully helping people find this advice)
  • emphasises that, in WSL 2 mode, WSL 2 commands must be working before Docker Desktop can start
  • highlight a common scenario where an android emulator is installed which disables Hyper-V (because it uses a conflicting hypervisor)

The structure is currently

  • WSL 2 only
  • Hyper-V only
  • Common to both

So add links to the WSL 2 section to the common section to make sure people realise it's relevant.

Related issues or tickets

Reviews

  • Technical review
  • Editorial review
  • Product review

@djs55 djs55 requested a review from aevesdocker as a code owner May 15, 2025 10:17
@netlify
Copy link

netlify bot commented May 15, 2025

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 424e8bd
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6825db06219a0d00088cf14b
😎 Deploy Preview https://deploy-preview-22645--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 May 15, 2025
@aevesdocker
Copy link
Contributor

hey @djs55, the PR changes aren't matching your PR description. Looks like the content we already have in docs. Perhaps need to push again?

Inspired by docker/for-win#14743

The troubleshooting contains the relevant info, but this PR

- explicitly mentions a common error code (hopefully helping people
  find this advice)
- emphasises that, in WSL 2 mode, WSL 2 commands must be working
  before Docker Desktop can start
- highlight a common scenario where an android emulator is installed
  which disables Hyper-V (because it uses a conflicting hypervisor)

The structure is currently

- WSL 2 only
- Hyper-V only
- Common to both

So add links to the WSL 2 section to the common section to make
sure people realise it's relevant.

Signed-off-by: David Scott <[email protected]>
Copy link
Contributor

@aevesdocker aevesdocker left a comment

Choose a reason for hiding this comment

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

Thank you @djs55, LGTM

@djs55
Copy link
Contributor Author

djs55 commented May 15, 2025

@aevesdocker thanks for the very fast review!

@aevesdocker aevesdocker merged commit 2884f73 into docker:main May 15, 2025
14 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