Docker Desktop is an application for MacOS and Windows machines for the building and sharing of containerized applications and microservices. Docker Desktop delivers the speed, choice and security you need for designing and delivering these containerized applications on your desktop.
Legacy desktop solution. Docker Toolbox is for older Mac and Windows systems that do not meet the requirements of Docker for Mac and Docker for Windows. We recommend updating to the newer applications, if possible.Estimated reading time: 10 minutes
Docker Toolbox provides a way to use Docker onWindows systems that do notmeet minimal system requirements for the Docker forWindows app.
If you have not done so already, download the installer here:
What you get and how it works
Docker Toolbox includes the following Docker tools:
- Docker CLI client 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
- 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-specifickernel features, you can’t run Docker Engine nativelyon Windows. Instead, you must use the Docker Machinecommand,
docker-machine, to create and attach to asmall Linux VM on your machine. This VM hosts Docker Enginefor you on your Windows system.
Tip: One of the advantages of the newerDocker forWindows solution is thatit uses native virtualization and does not requireVirtualBox to run Docker.
Step 1: Check your version
- Docker for Windows runs on 64-bit Windows 10 Pro, Enterprise, and Education; 1511 November update, Build 10586 or later. Docker plans to support more versions of Windows 10 in the future.
- After docker for windows is installed, the VM will restart and will take several minutes for docker to start. Once docker for windows is finished loading, you will want to ensure docker for windows is working correctly inside of the Windows 10 Hyper-V VM by pulling down the hello-world image and running it. Open a bash prompt and type the.
- Docker only supports Docker Desktop on Windows for those versions of Windows 10 that are still within Microsoft’s servicing timeline. Containers and images created with Docker Desktop are shared between all user accounts on machines where it is installed.
- Docker’s comprehensive end to end platform includes UIs, CLIs, APIs and security that are engineered to work together across the entire application delivery lifecycle. Build Get a head start on your coding by leveraging Docker images to efficiently develop your own unique applications on Windows and Mac.
To run Docker, your machine must have a 64-bit operating system running Windows 7 or higher. Additionally, you must make sure that virtualization is enabled on your machine.To verify your machine meets these requirements, do the following:
Right click the windows message and choose System.
If you aren’t using a supported version, you could consider upgrading your operating system.
If you have a newer system, specifically 64bit Windows 10 Pro, with Enterprise and Education (1607 Anniversary update, Build 14393 or later), consider using Docker for Windows instead. It runs natively on the Windows, so there is no need for a pre-configured Docker QuickStart shell. It also uses Hyper-V for virtualization, so the instructions below for checking virtualization will be out of date for newer Windows systems. Full install prerequisites are provided in the Docker for Windows topic in What to know before you 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 information.
For Windows 8 or 8.1
Choose Start > Task Manager and navigate to the Performance tab. Under CPU you should see the following:
If virtualization is not enabled on your system, follow the manufacturer’s instructions for enabling it.
For Windows 7
Run a tool like the Microsoft® Hardware-Assisted Virtualization Detection Tool or Speccy, and follow the on-screen instructions.
Verify your Windows OS is 64-bit (x64)
How you do this verification depends on your Windows version.
For details, see the Windows article How to determine whethera computer is running a 32-bit version or 64-bit version of theWindows operating system.
Step 2: Install Docker Toolbox
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 have a previous version of VirtualBox installed, do not reinstall it with the Docker Toolbox installer. When prompted, uncheck it.
If you have Virtual Box running, you must shut it down before running theinstaller.
Go to the Docker Toolbox page.
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 program to make a change, choose Yes. The system displays the Setup - Docker Toolbox for Windows wizard.
Press Next to accept all the defaults and then Install.
Accept all the installer defaults. The installer takes a few minutes to install all the components:
When notified by Windows Security the installer will make changes, make sure you allow the installer to make the necessary changes.
When it 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 yourApplications folder. In this step, you start Docker Toolbox and run a simpleDocker 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 make changes to your computer. Choose Yes.
The terminal does several things to set up Docker Toolbox for you. When it is done, the terminal displays the
The terminal runs a special
bashenvironment instead of the standard Windows command prompt. The
bashenvironment is required by Docker.
Make the terminal active by clicking your mouse next to the
If you aren’t familiar with a terminal window, here are some quick tips.
The prompt is traditionally a
$dollar sign. You type commands into thecommand line which is the area after the prompt. Your cursor is indicatedby a highlighted area or a
that appears in the command line. Aftertyping a command, always press RETURN.
docker run hello-worldcommand and press RETURN.
The command does some work for you, if everything runs well, the command’s output looks like this:
Looking for troubleshooting help?
Typically, the above steps work out-of-the-box, but some scenarios can cause problems. If your
docker run hello-world didn’t work and resulted in errors, check out Troubleshooting for quick fixes to common problems.
A Windows specific problem you might encounter relates to the NDIS6 host network filter driver, which is known to cause issues on some Windowsversions. For Windows Vista systems and newer, VirtualBox installs NDIS6 driver by default. Issues can range from system slowdowns to networking problems 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 driver.
Optional: Add shared directories
By default, Toolbox only has access to the
C:Users directory and mounts it intothe VMs at
Note: Within the VM path,
c is lowercase and the
Users is capitalized.
If your project lives elsewhere or needs access to otherdirectories on the host filesystem, you can add them, using the VirtualBox UI.
Open the VirtualBox UI.
Click the Settings gear, then go to Shared Folders.
Select any existing listing under Machine Folders, thenclick the + icon.
Choose the Folder Path on the host, enter the Folder Namefor within the VM (or take the default, which is the same nameas on the host), and configure any additional options you need.
Choose Auto-mount if you want the folder to automaticallybe mounted into the VM, and choose Make Permanent for itto be considered a permanently shared folder.
Click OK to add the new folder to the Shared Folders list.
Click OK again to save your changes and exit the Settings dialog.
How to uninstall Toolbox
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 Machine. In some cases, you might want to keep machines created with Docker Machine.
For example, if you plan to re-install Docker Machine as a part 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 plan to manage them using the provider, you wouldn’t want to remove them. So the step to remove machines is described here as optional.
To uninstall Toolbox on Windows, do the following:
List your machines.
Optionally, remove each machine. For example:
This step is optional because if you planto re-install Docker Machine as a partof Docker forWindows, you can import andcontinue to manage those machinesthrough Docker.
Uninstall Docker Toolbox using Window’s standard process for uninstalling programs through the control panel (programs and features).
Note: This process does not remove the
docker-install.exefile. You must delete that file yourself.
Optionally, remove the
If you want to remove Docker entirely, you can verify that the uninstall removed the
.dockerdirectory under your user path. If it is still there, remove it manually. This directory stores some Docker program configuration and state, such as information about created machines and certificates. You usually don’t need to remove this directory.
Uninstall Oracle VirtualBox, which is installed as a part of the Toolbox install.
Try out the Get started tutorial.
Dig in deeper with more tutorials and examples on building images, running containers, networking, managing data, and storing images on Docker Hub.
2 Answers. Docker for Windows requires Hyper-V, and Hyper-V requires Windows 10 Pro (or Windows Server). So no, you can’t run Docker without upgrading.
Does Docker need Windows Pro?
Requires Microsoft Windows 10 Professional or Enterprise 64-bit, or Windows 10 Home 64-bit with WSL 2. We updated the Docker Subscription Service Agreement on August 31, 2021. Please read the announcement and FAQs to learn more.
Does Docker run on Windows 10 pro?
Docker for Windows runs on 64-bit Windows 10 Pro, Enterprise, and Education; 1511 November update, Build 10586 or later. Docker plans to support more versions of Windows 10 in the future.
Does Docker support Windows 10 home?
You cannot install Docker for Windows on Windows 10 Home according to the documentation. System Requirements: Windows 10 64bit: Pro, Enterprise or Education (1607 Anniversary Update, Build 14393 or later). Install a Linux virtual machine (VM) on our Windows OS, and then Install Docker Community on the VM.
What version of Windows does Docker support?
Microsoft supports Windows Server containers for the following Windows versions and releases: Windows Server, version 1909, 2004 and 20H2 Standard Core or Datacenter Core. Windows Server 2016 (1607) Windows 10 Professional and Enterprise with Docker Desktop installed.
Why do you need Windows Pro for Docker?
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.
Does Docker need Hyper-V?
README for Docker Toolbox and Docker Machine users: Microsoft Hyper-V is required to run Docker Desktop. The Docker Desktop Windows installer enables Hyper-V if required, and restarts your machine. When Hyper-V is enabled, VirtualBox no longer works. However, any existing VirtualBox VM images are retained.
What is difference between Docker and Kubernetes?
A fundamental difference between Kubernetes and Docker is that Kubernetes is meant to run across a cluster while Docker runs on a single node. Kubernetes is more extensive than Docker Swarm and is meant to coordinate clusters of nodes at scale in production in an efficient manner.
Can I run Windows on Docker?
The Docker daemon provides each container with any necessary kernel-level properties so that the containerized application can run. The Windows Docker Desktop has the feature of providing Linux Subsystem; and in this case, running Linux container can ultimately run on Windows.
How can I tell if Docker is running?
The operating-system independent way to check whether Docker is running is to ask Docker, using the docker info command. You can also use operating system utilities, such as sudo systemctl is-active docker or sudo status docker or sudo service docker status , or checking the service status using Windows utilities.
Can we install Docker on Windows 10?
Docker only supports Docker Desktop on Windows for those versions of Windows 10 that are still within Microsoft’s servicing timeline. Containers and images created with Docker Desktop are shared between all user accounts on machines where it is installed.
How do I upgrade from Windows 10 home to professional?
Upgrade using a Windows 10 Pro product key Select the Start button, then select Settings > Update & Security > Activation . Select Change product key, and then enter the 25-character Windows 10 Pro product key. Select Next to start the upgrade to Windows 10 Pro.
What is Windows 20H2?
As with previous fall releases, Windows 10, version 20H2 is a scoped set of features for select performance improvements, enterprise features, and quality enhancements. To download and install Windows 10, version 20H2, use Windows Update (Settings > Update & Security > Windows Update).
Will there be a Windows 11?
Microsoft has officially announced Windows 11, the next major software update, which will be coming to all compatible PCs later this year. Microsoft has officially announced Windows 11, the next major software update that will be coming to all compatible PCs later this year.
Is Docker supported on Windows Server 2019?
As with all supported Windows Server versions, Docker Enterprise enables Windows Server 2019 and Server 1809 to be used in a mixed cluster alongside Linux nodes. Windows Server 2019 includes the following improvements: Ingress routing. VIP service discovery.
Is Docker compatible with Windows Server 2019?
Windows Server 2019 is the next long-term support release of Windows Server, and it’s available now! You can use the same Docker images, the same Dockerfiles and the same docker commands on Windows 10, but there’s an additional virtualization overhead, so it’s good to use a Windows Server VM for test environments.
Why do we go for Docker?
Developers can create containers without Docker, but the platform makes it easier, simpler, and safer to build, deploy and manage containers. Docker is essentially a toolkit that enables developers to build, deploy, run, update, and stop containers using simple commands and work-saving automation through a single API.
How do I run Docker?
Start an app container Start your container using the docker run command and specify the name of the image we just created: $ docker run -dp 3000:3000 getting-started. Remember the -d and -p flags? Go ahead and add an item or two and see that it works as you expect. You can mark items as complete and remove items.
Is Docker free to use?
Docker Desktop is licensed as part of a free (Personal) or paid Docker subscription (Pro, Team or Business). Docker Desktop may be used for free as part of a Docker Personal subscription for: Small companies (fewer than 250 employees AND less than $10 million in annual revenue) Personal use.
Is VirtualBox better than Hyper-V?
Docker Desktop For Windows
Hyper-V and Oracle VM VirtualBox can both be used to handle a businesses server virtualization needs, but they also have a few features that set them apart from each other. Hyper-V offers high performance virtual machines, and can output a lot of power depending on the hardware that it is running on.
Is WSL2 Hyper-V?
Docker For Windows 10 Pro 64 Bit
The newest version of WSL uses Hyper-V architecture to enable its virtualization. This architecture will be available in the ‘Virtual Machine Platform’ optional component.
Can Docker run in a VM?
The answer is a resounding “yes.” At the most basic level VMs are a great place for Docker hosts to run. Whether it’s a vSphere VM or a Hyper-V VM or an AWS EC2 instance, all of them will serve equally well as a Docker host. Depending on what you need to do, a VM might be the best place to land those containers.