Skip to content

troubleshooting: mention specific HCS_E_HYPERV_NOT_INSTALLED error code #22645

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 15, 2025

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
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