Skip to content
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.

Sign up for GitHub

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

Jump to bottom

Improve documentation for installing docker on Windows Home #191

Open
sebbacon opened this issue Mar 18, 2021 · 2 comments · May be fixed by #1038
Open

Improve documentation for installing docker on Windows Home #191

sebbacon opened this issue Mar 18, 2021 · 2 comments · May be fixed by #1038
Labels
improve content Improve existing documentation content

Comments

@sebbacon
Copy link
Contributor

This is what the official docs have to say:

  • Hyper-V and Containers Windows features must be enabled.
  • The following hardware prerequisites are required to successfully run Client Hyper-V on Windows 10:
    • 64 bit processor with Second Level Address Translation (SLAT)
    • 4GB system RAM
    • BIOS-level hardware virtualization support must be enabled in the BIOS settings. For more information, see Virtualization.

Our test user has a "very late" build of Windows 10 Home: they went through the requirements trying to find out if they had SLAT. They added:

I couldn’t get the virtualization stuff to work either.

There were a series of more & more complex things for a simpleton like me to do with Hyper-V and Containers Windows. I also enabled WSL1 but didn’t get WSL2 to go.

I don’t know if I was close to getting it going, but each time I got something, I found there was another 2 levels to negotiate.
@sebbacon
Copy link
Contributor Author

You probably know - in my opinion it's much better if the user installs WSL 2 if they can as Docker Desktop will use the WSL 2 engine (I want to say kernel) , in the Docker Desktop settings check the "Use WSL 2 based engine" box.
image
WSL 2 system calls run much faster than WSL 1.

~~ @remlapmot , opensafely-core/opensafely-cli#41 (comment)

@sebbacon sebbacon mentioned this issue Mar 18, 2021
Closed
@StevenMaude StevenMaude added the improve content Improve existing documentation content label May 11, 2021
@StevenMaude StevenMaude linked a pull request Dec 6, 2022 that will close this issue
Open
@StevenMaude
Copy link
Contributor

Windows Home doesn't have Hyper-V support.

But installation on Windows Home should be simpler now: Windows Home does support WSL2 and WSL2 is now the default recommendation from Docker for Docker Desktop. You do still require hardware that supports virtualisation (in other words, Intel VT-x or AMD-V), and that feature to be enabled in the BIOS, if it isn't by default.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
improve content Improve existing documentation content
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

Clarify Docker installation opensafely/documentation
2 participants
@sebbacon @StevenMaude