Skip to content

Docker for Windows

Jump to bottom
JCoulter85 edited this page Sep 5, 2019 · 5 revisions

Docker on Win 10 Home or Below

About

Docker for Win 10 Pro generally works fine out of the box.

With other versions, this is less the norm.

Docker uses Hyper-V and Win 10 home and previous versions of windows do not meet the requirements for the current Docker client. Check your version doc.

The solution for this is to use Docker Toolbox (deprecated) and disabling Hyper V in Win 10 (which uses Oracle Virtual Box instead of Hyper-V).

The recommended solution is to upgrade Windows 10 Pro, however using older versions is possible.

Another option is to use Linux. Create a bootable USB drive

Get Docker

Get Docker Toolbox

Steps to getting the Docker Toolbox to work on Windows 10 Home Edition

Step One: Check which OS you are currently running.

  • Click Start
  • Click Settings
  • Click System
  • Click About
  • Scroll down to Windows specifications and check your current OS edition
  • These instructions are specifically for Windows 10 Home
  • These steps may or may NOT work with other Windows Editions

Step Two: Download the Docker Toolbox. This will come with the Toolbox, Kitematic (alpha), and Oracle VM VirtualBox.

Step Three: Restart your machine. Setting up your VM

  • Right click and open both the Oracle VM VirtualBox and the Docker Quickstart Terminal as ADMINISTRATOR
  • If you’re like me, nothing works due to an IP issue, which is one of the most common issues from this download
  • In the Oracle VM right click the profile titled default located under the Tool header and remove it. If anything pops up just okay it. The profile will not work and will default auto re-populate each time the VM is opened without a profile. (You won't lose anything important by doing this)
  • After the profile has been removed, click on the File drop down located at the top left of the window.
  • Click on Check For Updates…
  • Let that run and okay any and all permissions. There will and should be an update OR these steps will not work
  • After the install restart your machine
  • Once you’re back up and running open the Oracle VM VirtualBox as ADMINISTRATOR.
  • At this point you will need to make sure that you have the correct shared folders
  • Right Click on the new default profile
  • Click Settings…
  • Click on Shared Folders and make sure that the Machine Folders have full access and Auto Mount is Yes
    Once we have done all of these steps, we should be able to start running things. Restart your machine.

Step Four: Jumping into Docker Quickstart Terminal.

  • Open your VM first AS ADMINISTRATOR
  • Then open your Docker Toolbox AS ADMINISTRATOR
  • If you have landed with everything running and the shell loads, you can now open up your own windows command prompt

Step Five: Windows Command Prompt

  • Open your folder where your store your SpeedUpAmerica content.
  • $ docker-compose up -d
  • $ docker-compose ps
  • Confirm all statuses are up / exiting with 0
  • $ docker-compose stop
  • Congrats!!! We have completed The Docker Toolbox upload on your machine and you can now view the web app.

Step Six: Making sure your able to view the web app on your local machine.

  • Bring your toolbox window and copy the IP address that it produced.
  • Open a new tab on your browser and paste/type in www.http://PASTE.YOUR.IP.ADDRESS:3000 If there are any errors within the Toolbox or the web app does not populate, please refer to the readme file in the SpeedUpAmerica github repository. These instructions are to just get docker running on your machine.

Here are some very useful links:

Clone this wiki locally