49

I am getting below error When I try to install Docker on Windows 10 Home Edition.

[21:20:49.129] [InstallWorkflow] Pre-requisite failed: Docker for Windows requires Windows 10 Pro or Enterprise version 14393, or Windows server 2016 RTM to run

Can I Install Docker on Windows 10 Home Edition?

1
  • 7
    You will need to use Docker Toolbox instead of standard Docker. Docker now uses native Windows virtualization, which is not supported on Win 10 Home.
    – user820304
    Apr 5, 2018 at 16:51

10 Answers 10

46

Edit Windows Version in Registry

  1. Press Windows + R and write regedit

  2. In the Registry Editor, go to \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion

  3. Right-click on EditionID and Click Modify

  4. Change Value Data to "Professional"

  5. Press OK.

  6. Install Docker

After the installation, you can change the EditionID back to "Core"

1
  • 1
    Seems strange to do this but seems to work. Thanks man!
    – erayner
    Aug 3, 2020 at 22:57
25

As the error says, you cannot use Docker in the Home edition. You need "Windows 10 Pro or Enterprise version 14393, or Windows server 2016 RTM."

Check out their documentation here, which mentions, on 04/05/2018:

The current version of Docker for Windows runs on 64bit Windows 10 Pro, Enterprise and Education (1607 Anniversary Update, Build 14393 or later).

As already mentioned in the comments, you might want to try the legacy Docker Toolbox:

Docker Toolbox is for older Mac and Windows systems that do not meet the requirements of Docker for Mac and Docker for Windows.

1
  • Thanks for mentioning this! It saved me. I spent hours trying to make Docker-compose / Docker Daemon work on Ubuntu via Windows10 in vain until I read this article confirming that it is in fact impossible (medium.com/@sebagomez/…) unless you have Docker Desktop for Windows which doesnt work on the Home Edition ... finally my problem was solved installing Docker Toolbox. Thank you!
    – Isaac
    Sep 10, 2019 at 21:35
9

Docker for Windows requires Hyper-V which is not included in Home edition. You'll need to upgrade Windows to the Education or Pro edition.

https://docs.docker.com/docker-for-windows/install/#what-to-know-before-you-install

Also see this comment on GitHub.

2
  • 2
    Hyper-V has been added to newer editions Windows 10 Home and yet it still will not install.
    – Taiger
    Aug 30, 2019 at 23:49
  • 1
    @Taiger maybe the installer checks for the version and not for the feature it really needs (Hyper-V in this case) Sep 10, 2019 at 11:48
1

You can already install Docker Desktop on Windows 10 Home. This is how I did it:

  1. You need to join Windows Insiders Program because you need WSL 2 Windows Insiders Program

  2. You need to download the specific version of Docker Desktop: https://download-stage.docker.com/win/edge/41944/Docker%20Desktop%20Installer.exe which has a required change - allows install it on Windows 10 Home. Docker Desktop Version

2
  • Actually Windows Insiders Program no longer required. Windows 10 Version 2004 has been officially released. May 28, 2020 at 23:03
  • 1
    That's true, and you no longer need the edge version of docker - Windows 10 Home support is already in stable version of Docker for Desktop.
    – kkoziarski
    Jun 1, 2020 at 5:37
1

Those who have Windows Home Edition can now download and install Docker Desktop from below link.

https://docs.docker.com/docker-for-windows/install-windows-home/

0

Although not on Win10 Home per se, for evaluation purposes you can install Docker Desktop on a Win10 Pro virtual machine (VMWare player is my personal choice). You'll need to install VMWare Workstation Player which is free, and obtain a perfectly legal Win10 Pro image from microsoft directly here: https://www.microsoft.com/en-us/software-download/windows10

Be sure to activate the virtualization engine of the machine as Docker relies on Hyper-V: VMWare virtualization settings

0

This is how I resolved the problem. (OS- windows 10 home)

  1. Join windows insider program. It enables you to update latest content of windows 10. You can find it in the start-> settings. Make sure to select Release Preview in the Insider program.(otherwise you will not get latest updates. After the installation you can pause frequent updates) enter image description here

  2. Check for windows update and update windows to latest version.(This will take awhile) enter image description here

  3. Install WSL 2 Linux kernel https://learn.microsoft.com/en-us/windows/wsl/wsl2-kernel

I had below issue because I have tried to install this before updating windows. Please read the document carefully and follow steps.

If the installer cant find WSL 1 right click the Linux kernel update installer, then press uninstall then rerun the installer

  1. Now you are ready to update to WSL 2. Follow steps of this doc

https://learn.microsoft.com/en-us/windows/wsl/install-win10

  • Open PowerShell as Administrator and run: dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

  • Enable the 'Virtual Machine Platform' Open PowerShell as Administrator and run: dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart Restart your machine to complete the WSL install and update to WSL 2.

You can verify whether this by looking at task manager. enter image description here

*Set WSL 2 as your default version In PowerShell: wsl --set-default-version 2

  1. Now you can install docker desktop version.
  2. Finally https://docs.docker.com/docker-for-windows/

This might not work for some. If you find any issues please post. I'll try to help.

0

This might help someone who cannot upgrade their system to pro or professional. Consider installing Docker Toolbox on Windows. For mac users: Docker Toolbox on Mac

Legacy desktop solution. Docker Toolbox is for older Mac and Windows systems that do not meet the requirements of 'Docker Desktop for Mac' and 'Docker Toolbox on Windows'. We recommend updating to the newer applications, if possible.

As per documentation, the toolbox includes these Docker tools:

  • Docker Machine for running docker-machine commands
  • Docker Engine for running the docker commands
  • Docker Compose for running the docker-compose commands
  • Kitematic, the Docker GUI
  • a shell preconfigured for a Docker command-line environment
  • Oracle VirtualBox
0

Get the latest update from https://www.microsoft.com/en-us/software-download/windows10 and it will work.

-2

First of all I'd like to thank the previous respondents to this questions - saved me a lot of time and yes, they are both correct.

Secondly as a small completion to their answer, in case you are wondering where you can get a Pro version of Windows without breaking the bank, you can get a relatively cheap and legal Windows 10 pro cd-key from ebay and upgrade you version from Windows settings -> Activation.

https://www.ebay.com/sch/i.html?_from=R40&_nkw=windows+10+pro&_sacat=0&_sop=15

Just make sure you read the sold product description well and eventually the reviews if there are so that you know what to expect (if you encounter any issue, ebay will refund your purchase). Best of luck to you all!

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.