-
Notifications
You must be signed in to change notification settings - Fork 5
Windows
This guide walks you through installing Docker on Windows 10/11 using Docker Desktop, with optional GPU support via WSL2 and NVIDIA drivers.
⚠️ Note: Windows setup can vary depending on version, hardware, and existing software.
If you hit issues, consult the official Docker docs, or ask in our Discord.
Download and install Docker Desktop for Windows:
During installation:
- Accept default settings
- Ensure "Use WSL2 instead of Hyper-V" is selected
- Reboot if prompted
Docker Desktop requires Windows Subsystem for Linux 2 (WSL2).
- Open PowerShell as Administrator and run:
wsl --install
-
Reboot your machine when prompted
-
After reboot, verify WSL2 is working:
wsl --status
It should show Default Version: 2 and your installed distro (like Ubuntu).
If needed, install Ubuntu from the Microsoft Store.
After installing Docker Desktop:
- Open Docker Desktop
- Go to Settings → Resources → WSL Integration
- Enable Docker integration for your Linux distro (e.g. Ubuntu)
If you have a supported NVIDIA GPU, you can run GPU-accelerated containers under WSL2.
- Windows 10 (Build 20145+) or Windows 11
- WSL2 enabled
- Recent NVIDIA GPU and drivers
-
Install the latest Windows GPU Driver for WSL:
👉 NVIDIA WSL Driver Download -
Inside WSL (e.g., Ubuntu), install
nvidia-container-toolkit:
sudo apt update
sudo apt install -y nvidia-container-toolkit
sudo systemctl restart docker
To test Docker and GPU support (inside WSL):
docker run --rm --gpus all nvidia/cuda:12.0-base nvidia-smi
You should see GPU details printed if everything is working.
To test Docker in general:
docker run hello-world
Once Docker is installed and WSL2 is ready, continue here:
🚀 Launching the JoeyLLM Development Container