HEP DEV Docs
GitHubToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeBack to homepage

Docker on Windows

Docker is a useful tool to create specific, isolated enviroments on your machine. On Windows 10, Docker can run within the WSL 2 setup thus providing you with a solid Docker-on-Linux experience. The latter means it is easy to share files and ports between the Linux OS and the Docker images. It also allows you to make full use of all the Docker image and Docker Compose examples (i.e. no special Windows treatment).

Installing Docker

To install Docker, head to the Docker Hub to download the latest Community Edition of Docker (stable version).

Download Docker Desktop for Windows
Download Docker Desktop for Windows

You will need at least Docker version 2.3.0.2 and Windows 10 version 2004 or higher for all the features discussed on these pages. Please make sure to install WSL 2 before installing Docker. If everything is setup correctly, you should see the following during the Docker installation:

Install Docker Desktop for Windows
Install Docker Desktop for Windows

Additional installation help as well as OS requirements for the install are detailed on the Windows Docker pages.

Note: You will be required to log out of Windows to complete the installation.

Checking the installation

In order to verify, open your Ubuntu WSL 2 terminal and type

docker ps

docker run hello-world

You should see something similar to:

Test Docker installation
Test Docker installation