Last year we announced that Docker had released a preview of Docker Desktop with WSL 2 integration. We are now pleased to announce that we have completed the work to enable experimental support for Windows Home WSL 2 integration. This means that Windows Insider users on 19040 or higher can now install and use Docker Desktop!
Feedback on this first version of Docker Desktop for Windows Home is welcomed! To get started, you will need to be on Windows Insider Preview build 19040 or higher and install the Docker Desktop Edge 2.2.2.0.
What’s in Docker Desktop for Windows Home?
Docker Desktop for WSL 2 Windows Home is a full version of Docker Desktop for Linux container development. It comes with the same feature set as our existing Docker Desktop WSL 2 backend. This gives you:
- Latest version of Docker on your Windows machine
- Install Kubernetes in one click on Windows Home
- Integrated UI to view/manage your running containers
- Start Docker Desktop in <5 seconds
- Use Linux Workspaces
- Dynamic resource/memory allocation
- Networking stack, support for http proxy settings, and trusted CA synchronization
How do I get started developing with Docker Desktop?
For the best experience of developing with Docker and WSL 2, we suggest having your code inside a Linux distribution. This improves the file system performance and thanks to products like VSCode mean you can still do all of your work inside the Windows UI and in an IDE you know and love.
Firstly make sure you are on the Windows insider program, are on 19040 and have installed Docker Desktop Edge.
Next install a WSL distribution of Linux (for this example I will assume something like Ubuntu from the Microsoft store).
You may want to check your distro is set to V2, to check in powershell run
wsl -l -v
If you see your distro is a version one you will need to run
wsl ‐‐set-version DistroName 2
Once you have a V2 WSL distro, Docker Desktop will automatically set this up with Docker.
The next step is to start working with your code inside this Ubuntu distro and ideally with your IDE still in Windows. In VSCode this is pretty straightforward.
You will want to open up VSCode and install the Remote WSL extension, this will allow you to work with a remote server in the Linux distro and your IDE client still on Windows.
Now we need to get started working in VSCode remotely, the easiest way to do this is to open up your terminal and type:
Wsl
code .
This will open a new VSCode connected remotely to your default distro which you can check in the bottom corner of the screen.
(or you can just look for Ubuntu in your start menu, open it and then run code . )
Once in VSCode there I use the terminal in VSCode to pull my code and start working natively in Linux with Docker from my Windows Home Machine!
Other tips and tricks:
- If you want to get the best out of the file system performance avoid mounting from the windows file system (even from a WSL distro. eg:
avoid docker run -v /mnt/c/users:/users) - If you are worried about the size of the docker-desktop-data VHDX or need to change it you can do this through the WSL tooling built into Windows:
https://docs.microsoft.com/en-us/windows/wsl/wsl2-ux-changes#understanding-wsl-2-uses-a-vhd-and-what-to-do-if-you-reach-its-max-size - If you are worried about CPU/Memory usage you put limits on memory/cpu/swap size on the WSL2 utility VM https://docs.microsoft.com/en-us/windows/wsl/release-notes#build-18945
Your feedback needed!
We are excited to get your feedback on the first version of Docker Desktop for Windows Home and for you to tell us how we can make it even better.
To get started with WSL 2 Docker Desktop on Windows home today you will need to be on Windows Insider Preview build 19040 or higher and install the Docker Desktop Edge 2.2.2.0.