Windows Apps & tools

Install WSL2 on Windows

Run Linux tools on Windows with WSL2 — the supported Microsoft path for dev and admin tasks.

14 min read Beginner Updated 9 Jun 2026

Step-by-step guide

Work through each section in order. Stop when your issue is resolved — you do not need every step for every situation.

Warning

Use an administrator account for these steps, and keep a recent backup before making repair or security changes.

What you will achieve

Run Linux tools on Windows with WSL2 — the supported Microsoft path for dev and admin tasks.

1) Install from elevated PowerShell

Run:

wsl --install
wsl --set-default-version 2

2) Reboot and complete distro setup

  1. Restart when prompted.
  2. On first distro launch, create Linux username/password.

3) Verify WSL status

wsl --status
wsl -l -v

Related guides

developer linux windows wsl2