DEV Community


Using Docker on a Windows 10 Home Edition

begrossi profile image Bruno E. Grossi ・2 min read

I like Linux. And I used it for many years. But now, I need to use some software that does not support Linux. So, I'm using Windows 10 here. And it is a Windows 10 Home Edition. Docker does not support it on its official release. So, you need to get the legacy Docker Toolbox.

But, why the native version does not work?

A Docker container should be isolated from all other machine resources not granted by the user. For this, it uses Linux's namespace and control groups. From this article:

Linux namespaces are provided and supported by Linux kernel to allow separation (virtualization) of process ID space (PID numbers), network interfaces, interprocess communication (IPC), mount points and kernel information.
Control groups in Linux allow accurate resource control: using control groups allows Docker to limit CPU or memory usage for each container.

To run Docker "natively" on Windows, they don't have namespaces and control groups. So, developers use Hyper-V virtual hosts to create this isolation. However, Windows 10 Home does not support Hyper-V functions. Hyper-V specifically provides hardware virtualization and process isolation. That's why we need the legacy Docker toolbox.

Docker Toolbox is a solution that uses Oracle's VirtualBox Headless mode to run Docker on a Linux virtual container.

Docker Toolbox setup

Explaining the trick

The trick here is that Docker is separated into two parts. A docker client and an engine daemon. So, Toolbox uses a tool, called docker-machine to create a Linux virtual machine and run a Docker Engine inside it. It's not a native solution but works very well. The Docker client may be used to control not only a local docker but a remote one too. So, we only need this windows client (included on toolbox) and point it to our virtual server. This can be done settings some environment variables, and the command docker-machine.exe env teaches you how to do this. I will talk about docker-machine utility in another post.

But, to be more productive, Toolbox comes with a utility shell script that checks it docker's VM machine is running and starts it if not. It's used through the Docker Quickstart Terminal link created on Windows' Start Menu. This link simply call a git's bash.exe (or some other Linux terminal ported to windows) and execute a (you can see it here).

Originally posted on, on May 3, 2019

Do you know best practices and more information about running Docker on Windows Home edition? Share it on comments!


Editor guide