Skip to content

WSL Version Compatibility Guide ​

If your WSL version is detected as outside WSL Dashboard's supported range, the app will show a warning. Running on an unsupported version may cause two problems:

  • There is a risk to your data: operations such as compress, sparse VHD, clone, import, and export directly read and write virtual disks, which may cause data corruption on an unsupported version.
  • Some features may not work properly: for example, configuration items such as [boot], [gpu], and [time] are not supported on older versions.

Please update WSL to a supported version before using the full feature set.

1. Check your current version ​

Open PowerShell as Administrator and run:

powershell
wsl --version

Note down the value in the "WSL Version" line. If the command errors out or this line is missing, you are using the older inbox version of WSL bundled with Windows — go straight to the upgrade steps below.

2. How to upgrade ​

First, go to the official release page:

https://github.com/microsoft/WSL/releases/latest

Choose the latest (or a currently supported) version, download wsl.<version>.x64.msi (choose arm64 on ARM64 devices), then double-click to install.

Requires Windows 10 21H2 or later, with the "Virtual Machine Platform" feature enabled under "Turn Windows features on or off".

Option 2: Update via the command line ​

Open PowerShell as Administrator and run:

powershell
wsl --update

If the Microsoft Store is unavailable, force the download instead:

powershell
wsl --update --web-download

3. After upgrading ​

powershell
wsl --shutdown
wsl --version

Once you confirm the version is within the supported range, fully exit and restart WSL Dashboard, and the warning will disappear.