Skip to content

Instantly share code, notes, and snippets.

@Stamo-Gochev
Forked from hakiri/wsl2-docker.md
Last active November 19, 2021 07:13
Show Gist options
  • Save Stamo-Gochev/abb2ef402331816f48e2c275ecfa1e2a to your computer and use it in GitHub Desktop.
Save Stamo-Gochev/abb2ef402331816f48e2c275ecfa1e2a to your computer and use it in GitHub Desktop.
Instruction how to set up WSL2 to work with Docker in Windows 10

On Windows 10 build 18917 or higher

Win / Enable WSL and VMP

PowerShell:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

// requires restart
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

Win / Set WSL 2 as default

PowerShell:

wsl --set-default-version 2

Win / Install Linux distro from Microsoft Store

For example Ubuntu 18.04 LTS

Win / Optional: Install X11 server

For example VcXsrv.

WSL / Optional: Prepare for X11 on Windows

Add to ~/.bashrc (provide IP of your Windows host):

export DISPLAY=192.168.1.11:0

Win / Install Docker Desktop Edge

Download version 2.1.6.0 or search for latest.
Enable Enable the experimental WSL 2 based engine on General tab.
Enable your WSL distro on Resources tab.

WSL / Install Docker

Bash:

sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install docker-ce
sudo gpasswd -a $USER docker
sudo mkdir /sys/fs/cgroup/systemd
sudo mount -t cgroup -o none,name=systemd cgroup /sys/fs/cgroup/systemd
sudo service docker start

WSL / Verify

Bash:

docker info
docker run hello-world
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment