Skip to content

WSL2 - Docker Dev - Ubuntu 22.04

The purpose of this repo is to regularly rebuild a WSL2 image from Ubuntu 22.04, with docker engine, git, ssh, gpg and VSCode dependencies included.

This image can run in parallel without conflict* with other windows docker solutions like Docker Desktop and Rancher Desktop.

Note: Rancher Desktop itself can mess up docker in a WSL distribution even if its service is not enabled on that distribution.

What it includes

  • docker engine
  • installed with linux instructions (apt-get install docker)
  • ssh-agent
  • the one that comes with linux
  • including an .ssh/config to start with
  • gpg-agent
  • with a utility to help configure git commit signing
  • .gitconfig
  • with sensible defaults to start with, and plenty of aliases

All of the above is provided by a separate project that this one and its sibling uses. See common/dev-setup README for more info.

How to import this WSL image in your Windows desktop

The instructions on how to import a WSL image is generated by a pipeline for each new tag.

See the latest Release to get started.

What can you do with an imported WSL image

You can do a lot of things right away with your new image other then docker ps.

See the common/dev-setup README for all the information on what you can do with it.


All frequently asked questions are in common/dev-setup README.

Propose changes to this page