How to Downgrade WSL 2 to WSL 1 (wsl --set-version)

🐧Part of the WSL Complete Guide, every Windows Subsystem for Linux post on this site, organised by task.

To move a WSL distro from WSL 2 to WSL 1, run this in PowerShell or Command Prompt, using the distro name from wsl -l -v:

PowerShell
wsl --set-version Debian 1

Change the 1 to a 2 to move it back. For the other direction in full, see How to Upgrade WSL from Version 1 to Version 2.

Check Which Version Each Distro Uses

PowerShell
wsl -l -v

On this Windows 11 machine:

Code
  NAME              STATE           VERSION
* Ubuntu            Stopped         2
  docker-desktop    Running         2

The version is set per distro, not for WSL as a whole, so WSL 1 and WSL 2 distros can sit side by side. The * marks the default distro. Leave docker-desktop alone: it belongs to Docker Desktop. More on this in How to Check WSL Distro Versions.

Convert the Distro

Microsoft warns that switching between versions can take a while and can fail on large distros, so take a backup first with wsl --export (How to Back Up and Restore a WSL Distro). Then:

PowerShell
# check wsl distro versions
wsl -l -v

# change the distro using the name above to the version you want
wsl --set-version Debian 1
WSL Set Version

The Debian distro marked in the screenshot above has gone from WSL 2 to WSL 1. Run wsl -l -v again to confirm the VERSION column now shows 1.

If WSL 1 Is Not Enabled

On Windows 11 and current Windows 10, wsl --install installs WSL from the Microsoft Store. WSL 1 also needs the “Windows Subsystem for Linux” optional component, which that install does not turn on unless you ask for it with wsl --install --enable-wsl1. If the conversion to version 1 fails, enable the component from an elevated prompt and restart Windows:

Code
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Make New Distros Use WSL 1

PowerShell
wsl --set-default-version 1

This only affects distros installed from now on. wsl --status shows the current default:

Code
Default Distribution: Ubuntu
Default Version: 2

Why Go Back to WSL 1?

WSL 2 runs a real Linux kernel in a lightweight VM and is the right default for most work. WSL 1 is still faster when you mostly work on files stored on the Windows side, under /mnt/c, and it does not need the virtualisation that WSL 2 depends on, which can matter inside a VM.

If a conversion fails with an error you do not recognise, paste it into Claude Code and ask what it means. That’s what it’s there for.

Frequently Asked Questions

Does downgrading delete my files?

No, the distro is converted in place and keeps its files. Microsoft still recommends a backup first, because a failed conversion on a large distro is possible.

How long does the conversion take?

It depends on the size of the distro. WSL prints “Conversion in progress, this may take a few minutes” and then “Conversion complete”.

Can I run WSL 1 and WSL 2 distros at the same time?

Yes. The version is per distro, as the screenshot above shows with Ubuntu on 1 and Ubuntu-20.04 on 2.

How do I check which WSL I have installed overall?

wsl --version shows the WSL package, kernel and Windows versions. wsl -l -v shows the version each distro runs.

Related

If SQL Server is part of your day job, my current work lives over at sqldba.blog: production DBA scripts, an error library and the SSMS guide.