Skip to content

Docker_Installation_Win10_Home.md

Latest commit

 

History

History
72 lines (66 loc) · 4.58 KB

Docker_Installation_Win10_Home.md

File metadata and controls

72 lines (66 loc) · 4.58 KB

Docker Installation on Windows 10 Home

Written by Tanner Stern
GitHub: tannerstern
Last updated: 04/07/2020

Sources: hessi9's post and mapk's post on the Installing Docker on Windows 10 Home discussion

Pre-Installation Notes

  • Follow these instructions in order because the order matters
  • Pay attention to details; this is not a hard tutorial to follow, but it is complicated
  • If you run into problems, do not despair! Contact the professor and patiently troubleshoot

Step 1: Install Hyper-V and Container

  1. Save and close any open documents or projects
    • Your computer will restart multiple times throughout this installation
  2. Download hyperv.bat and containers.bat
    • Instructions for downloading:
      1. Follow one of the links above
      2. Click "Raw" on the right side of the page
      3. On the page that appears, right-click and "Save Page As..."
      4. In the dialog that appears, navigate to your desired folder and add .bat to the end of the file name
      5. Save the file and repeat the process for the other file
    • Put them in an easily accessible folder
    • These files are Windows Batch files. They will install Windows Components necessary to make Docker run.
    • If you get a warning from Windows Smartscreen, click "More info" and then "Run anyway." This is your computer recognizing these files as downloaded from the internet and being cautious about running them.
  3. Right-click on the hyperv.bat and select "Run as administrator"
    • The command prompt will open
    • You will see several progress bars flash in the window
    • This installation will take a few minutes
  4. When prompted, type y to restart your computer
    • This prompt will appear in the command prompt after the batch file runs
  5. When the restart is completed, do the same for container.bat
    • Remember to right-click and "Run as administrator"
    • When prompted, type y to restart your computer

Step 2: Make Registry Changes

  1. Note: Be very careful in this next section
    • Editing the Windows registry is like performing open-heart surgery
    • Follow these directions exactly and make only those changes described here
    • Do not restart your computer until this tutorial is over (as a precaution)
  2. Open the Windows registry editor tool
    • This can be done by clicking the Start button and typing "regedit" or searching for "Registry Editor"
  3. Navigate to \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion
    • Use the folder tree on the left side of the window
    • When you get to CurrentVersion, make sure you have clicked on (selected) the CurrentVersion folder and not one of its subfolders
  4. Find the EditionID key
    • After you have selected CurrentVersion, you will see keys and values on the right side of the window
    • The keys are arranged alphabetically by default
  5. Right-click and "Modify..." the EditionID; change it from "Core" to "Professional"
    • The initial value of the key should be "Core"
    • We want to change this value to "Professional" (case-sensitive)
    • We will undo this change after we install Docker
  6. Click "OK" but leave the Registry Editor window open

Step 3: Install Docker

  1. If you haven't already, download the Docker installer
  2. Run the installer as you would any other installer
    • The default settings are fine
    • If you encounter any errors that reference "Hyper-V" or "Containers" as missing, you might have missed something in Step 1. Go back and check.
    • If you encounter any errors that reference how you need Windows Pro, you might have missed something in Step 2. Go back and check.
  3. The installer will notify you when it has installed successfully
    • You are almost done!
  4. Go back to the Registry Editor and change EditionID back to "Core"
    • This is a very important step, do not skip it!
    • Make sure you click "OK" and close the Registry Editor when you are done

Final Notes

  • Docker can take a long time to start up, so if it seems like it is not opening, be patient
  • Docker may be running after the installation
  • You can tell if Docker is running by looking at your system tray
    • This is the area of your taskbar by the clock (bottom-right)
    • Docker might be hidden; click the arrow to expand the tray to see all icons