Skip to content

Install Windows Subsystem for Linux (WSL)

The Windows Subsystem for Linux (WSL) allows developers run a GNU/Linux environment -- including most command-line tools, utilities, and applications -- directly on Windows, unmodified, without the overhead of a virtual machine.

Official Documentation

WSL1 or WSL2

WSL2 is built using a full Linux kernal and is optimised for size and performance. It also solves many of the networking and Docker integration challenges that were present in WSL1.

WSL1 requires significantly more manual setup. The remainder of this guide will assume WSL2 is being used.

For further information on the differences between WSL1 and WSL2, see the Microsoft documentation.

Installation

Follow the below Microsoft guide to install the distro of your choice. The Ubuntu distro is recommended.

Installation Guide

Within the guide there is also a recommended setup of a development environment using WSL.

This guide should also be followed as it includes setup of Docker Desktop, Git, Windows Terminal and VS Code.