Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
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:

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
@richeney

This comment has been minimized.

Copy link

@richeney richeney commented May 6, 2020

Good instructions. One thing - the

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –

line errored on my Ubuntu 18.04 when I copy and paste it in, even from the raw It looks like the hyphen at the end has some odd control characters around it? (Is it an em dash or en dash rather than a hyphen?)

/git $ echo 'curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –' | cat -tev
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add M-bM-^@M-^S$
@ChristophShyper

This comment has been minimized.

Copy link
Owner Author

@ChristophShyper ChristophShyper commented May 6, 2020

Thanks for reporting it. I made it on Windows so it must have change characters and didn't notice that. Fixed now.

@jfmatth

This comment has been minimized.

Copy link

@jfmatth jfmatth commented Apr 10, 2021

I gave up on Docker and went to podman, much much simpler.

https://www.redhat.com/sysadmin/podman-windows-wsl2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment