Windows
πͺ Option 1: Install Docker Desktop (Recommended)β
Works on: Windows 10/11 (Pro, Enterprise, or Education) β for Home edition, Docker uses WSL2 (no Hyper-V).
πΉ Step 1: Install WSL2 (for Windows Home or modern Windows 11 Pro)β
-
Open PowerShell as Administrator and run:
wsl --install -
Restart your machine.
-
Confirm WSL2 is default:
wsl --set-default-version 2
πΉ Step 2: Download Docker Desktopβ
- Go to: https://www.docker.com/products/docker-desktop
- Download the installer and run it.
During installation:
- Enable WSL 2 backend (recommended).
- Allow it to install the required WSL distributions (e.g., Ubuntu).
πΉ Step 3: Launch Docker Desktopβ
- Start Docker Desktop from the Start menu.
- It will take a few seconds to initialize.
- Confirm it's running via the system tray π³.
πΉ Step 4: Test Installationβ
Open PowerShell or Command Prompt and run:
docker version
docker run hello-world
If you see the "Hello from Docker!" message β it's working β
π οΈ Option 2: Install Docker without Docker Desktop (Advanced)β
If you donβt want to use Docker Desktop (e.g., for licensing reasons), you can install Docker CLI & Engine manually on WSL2:
πΈ Steps:β
-
Install WSL2 and a Linux distro (e.g., Ubuntu):
wsl --install -d Ubuntu -
Inside WSL (Ubuntu shell):
sudo apt update
sudo apt install docker.io
sudo usermod -aG docker $USER -
Enable Docker service:
sudo service docker start -
Run Docker commands:
docker run hello-world
β οΈ You must start Docker service manually every time unless you configure it to auto-start.