Skip to content

Instantly share code, notes, and snippets.

@paulo-raoni
Last active June 7, 2020 00:37
Show Gist options
  • Save paulo-raoni/a5fed4d9001dd0c1c0f44b9c7814dda6 to your computer and use it in GitHub Desktop.
Save paulo-raoni/a5fed4d9001dd0c1c0f44b9c7814dda6 to your computer and use it in GitHub Desktop.

Docker Windows 10 Home Edition installation

Installation Failed: one prerequisite is not fulfilled

Docker Desktop requires Windows 10 Pro or Enterprise version 15063 to run.

The reason why Docker needs Windows Pro or Enterprise is that they are using Hyper-V and Containers. Let’s install these.

SOLUTION:

Install Hyper-V and Containers

1 - Create a file called InstallHyperV.bat

2 - Add this content:

pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V -All /LimitAccess /ALL
pause

3 - Run InstallHyperV.bat in administrator mode.

4 - Create a file called InstallContainers.bat

5 - Add this content:

pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*containers*.mum >containers.txt
for /f %%i in ('findstr /i . containers.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del containers.txt
Dism /online /enable-feature /featurename:Containers -All /LimitAccess /ALL
pause

6 - Run InstallContainers.bat in administrator mode.

7 - Restart your computer

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.

Install Docker

⚠️ If you restart your computer the EditionID will be reset and you have to set it again.

Great Job! ⭐️ Now, run the Docker installer again. It should proceed without any problems. After the installation, you can change the EditionID back to Core

That’s it! I hope you got everything working and are up and running with docker!

TROUBLESHOOTING

1- Problems with VM virtualization or an Android simulator may occur (depending on type of simulator - ex: bluestacks). In these cases there aren't any official solution from Docker community. So if you want to use Docker, can't use Bluestacks and vice versa.

2- In case of a try to disable hyper-v to use bluestacks, for exemple, and you couldn't rehab it to use Docker again, one solution is to execute the .bat files again (described above). Case it doesn't work, you can see this issue answered at stackoverflow in this link bellow:

https://stackoverflow.com/questions/39684974/docker-for-windows-error-hardware-assisted-virtualization-and-data-execution-p

REFERENCES:

  1. https://itnext.io/install-docker-on-windows-10-home-d8e621997c1d
  2. https://forums.docker.com/t/installing-docker-on-windows-10-home/11722/25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment