How To Install Docker Toolbox On Windows 10 Home

Install Docker Toolbox on Windows

Legacy desktop solution. Docker Toolbox is for older Mac and Windows systems that do not encounter the requirements of Docker for Mac and Docker for Windows. Nosotros recommend updating to the newer applications, if possible.

Estimated reading time: x minutes

Docker Toolbox provides a mode to apply Docker on Windows systems that do not meet minimal arrangement requirements for the Docker for Windows app.

If yous have non done and so already, download the installer here:

Get Docker Toolbox for Windows

What you go and how it works

Docker Toolbox includes the post-obit Docker tools:

Docker CLI customer for running Docker Engine to create images and containers
Docker Machine so you can run Docker Engine commands from Windows terminals
Docker Compose for running the docker-compose command
Kitematic, the Docker GUI
the Docker QuickStart shell preconfigured for a Docker command-line environment
Oracle VM VirtualBox

Because the Docker Engine daemon uses Linux-specific kernel features, you can't run Docker Engine natively on Windows. Instead, you must use the Docker Auto control, docker-automobile, to create and adhere to a small Linux VM on your car. This VM hosts Docker Engine for you on your Windows system.

Tip: I of the advantages of the newer Docker for Windows solution is that information technology uses native virtualization and does not require VirtualBox to run Docker.

Footstep 1: Cheque your version

To run Docker, your machine must accept a 64-bit operating organisation running Windows seven or college. Additionally, you must make sure that virtualization is enabled on your automobile. To verify your machine meets these requirements, practice the following:

Right click the windows bulletin and choose Arrangement.

If yous aren't using a supported version, y'all could consider upgrading your operating system.

If you have a newer system, specifically 64bit Windows 10 Pro, with Enterprise and Pedagogy (1607 Anniversary update, Build 14393 or later), consider using Docker for Windows instead. It runs natively on the Windows, so in that location is no need for a pre-configured Docker QuickStart beat. It also uses Hyper-Five for virtualization, then the instructions below for checking virtualization will be out of appointment for newer Windows systems. Full install prerequisites are provided in the Docker for Windows topic in What to know before y'all install.
Make sure your Windows system supports Hardware Virtualization Technology and that virtualization is enabled.

For Windows 10

Run Speccy, and look at the CPU data.

For Windows viii or 8.1

Choose Start > Task Manager and navigate to the Performance tab. Under CPU you should see the post-obit:

If virtualization is non enabled on your system, follow the manufacturer's instructions for enabling information technology.

For Windows 7
Verify your Windows Os is 64-chip (x64)

How you do this verification depends on your Windows version.
For details, see the Windows article How to determine whether a estimator is running a 32-bit version or 64-bit version of the Windows operating organization.

In this section, you install the Docker Toolbox software and several "helper" applications. The installation adds the following software to your machine:

Docker Client for Windows
Docker Toolbox management tool and ISO
Oracle VM VirtualBox
Git MSYS-git UNIX tools

If you lot have a previous version of VirtualBox installed, do non reinstall it with the Docker Toolbox installer. When prompted, uncheck it.

If you have Virtual Box running, you must close information technology down before running the installer.

Go to the Docker Toolbox folio.
Click the installer link to download.
Install Docker Toolbox by double-clicking the installer.

The installer launches the "Setup - Docker Toolbox" dialog.

If Windows security dialog prompts you to allow the programme to make a change, cull Aye. The arrangement displays the Setup - Docker Toolbox for Windows magician.
Press Side by side to take all the defaults and and then Install.

Accept all the installer defaults. The installer takes a few minutes to install all the components:
When notified past Windows Security the installer will make changes, make sure you allow the installer to make the necessary changes.

When information technology completes, the installer reports it was successful:
Uncheck "View Shortcuts in File Explorer" and press Finish.

Step 3: Verify your installation

The installer adds Docker Toolbox, VirtualBox, and Kitematic to your Applications folder. In this stride, you lot start Docker Toolbox and run a simple Docker command.

On your Desktop, find the Docker QuickStart Terminal icon.
Click the Docker QuickStart icon to launch a pre-configured Docker Toolbox terminal.

If the system displays a User Account Control prompt to allow VirtualBox to brand changes to your computer. Choose Yes.

The final does several things to set upward Docker Toolbox for you. When it is washed, the terminal displays the $ prompt.

The terminal runs a special bash environment instead of the standard Windows command prompt. The bash surroundings is required by Docker.
Brand the terminal agile past clicking your mouse side by side to the $ prompt.

If yous aren't familiar with a final window, here are some quick tips.

The prompt is traditionally a $ dollar sign. You type commands into the control line which is the expanse after the prompt. Your cursor is indicated by a highlighted area or a | that appears in the command line. After typing a command, ever printing RETURN.

Blazon the docker run hello-world command and press RETURN.

The command does some work for yous, if everything runs well, the control'due south output looks like this:

                                  $ docker run how-do-you-do-world  Unable to discover epitome 'hello-world:latest' locally  Pulling repository hello-world  91c95931e552: Download complete  a8219747be10: Download complete  Condition: Downloaded newer image for hi-world:latest  Hello from Docker.  This message shows that your installation appears to be working correctly.   To generate this message, Docker took the following steps:   i. The Docker Engine CLI client contacted the Docker Engine daemon.   2. The Docker Engine daemon pulled the "hello-world" image from the Docker Hub.      (Assuming information technology was not already locally bachelor.)   iii. The Docker Engine daemon created a new container from that paradigm which runs the      executable that produces the output you are currently reading.   four. The Docker Engine daemon streamed that output to the Docker Engine CLI client, which sent it      to your terminal.   To effort something more ambitious, you can run an Ubuntu container with:   $ docker run -information technology ubuntu bash   For more examples and ideas, visit:   https://docs.docker.com/userguide/

Looking for troubleshooting help?

Typically, the above steps piece of work out-of-the-box, but some scenarios can crusade issues. If your docker run hello-world didn't work and resulted in errors, cheque out Troubleshooting for quick fixes to common problems.

A Windows specific problem you might meet relates to the NDIS6 host network filter commuter, which is known to cause issues on some Windows versions. For Windows Vista systems and newer, VirtualBox installs NDIS6 driver by default. Bug can range from system slowdowns to networking issues for the virtual machine (VM). If you notice problems, re-run the Docker Toolbox installer, and select the option to install VirtualBox with the NDIS5 commuter .

By default, Toolbox only has admission to the C:\Users directory and mounts information technology into the VMs at /c/Users.

Note: Within the VM path, c is lowercase and the Users is capitalized.

If your projection lives elsewhere or needs admission to other directories on the host filesystem, y'all can add them, using the VirtualBox UI.

Open up the VirtualBox UI.
Click the Settings gear, so go to Shared Folders.
Select whatever existing listing under Auto Folders, and so click the + icon.
- Choose the Folder Path on the host, enter the Binder Proper noun for inside the VM (or take the default, which is the same name as on the host), and configure any additional options you need.
- Choose Machine-mount if you desire the folder to automatically exist mounted into the VM, and choose Make Permanent for it to be considered a permanently shared folder.
Click OK to add the new binder to the Shared Folders list.
Click OK again to save your changes and exit the Settings dialog.

Removing Toolbox involves removing all the Docker components it includes.

A full uninstall also includes removing the local and remote machines you created with Docker Car. In some cases, y'all might want to proceed machines created with Docker Car.

For example, if you plan to re-install Docker Machine as a function of Docker for Windows you can continue to manage those machines through Docker. Or, if you have remote machines on a cloud provider and you programme to manage them using the provider, yous wouldn't want to remove them. So the pace to remove machines is described hither every bit optional.

To uninstall Toolbox on Windows, practice the post-obit:

List your machines.

                $ docker-machine ls Name                Agile   Commuter       STATE     URL                        SWARM dev                 *        virtualbox   Running   tcp://192.168.99.100:2376 my-docker-machine            virtualbox   Stopped default                      virtualbox   Stopped

Optionally, remove each machine. For example:
```
                $ docker-machine rm my-docker-machine Successfully removed my-docker-machine                              
```
This pace is optional because if y'all programme to re-install Docker Machine as a part of Docker for Windows, you tin can import and continue to manage those machines through Docker.
Uninstall Docker Toolbox using Window'southward standard process for uninstalling programs through the control panel (programs and features).

Note: This process does not remove the docker-install.exe file. Y'all must delete that file yourself.
Optionally, remove the C:\Users\<your-user>\.docker directory.

If you desire to remove Docker entirely, you tin can verify that the uninstall removed the .docker directory under your user path. If it is still there, remove it manually. This directory stores some Docker plan configuration and state, such as information about created machines and certificates. You unremarkably don't need to remove this directory.
Uninstall Oracle VirtualBox, which is installed equally a part of the Toolbox install.

Adjacent steps

Try out the Go started tutorial.
Dig in deeper with more tutorials and examples on building images, running containers, networking, managing information, and storing images on Docker Hub.
Larn almost Kitematic
Acquire nearly Docker Machine
Larn about Docker Compose