Check your WSL version from Windows Command Prompt
Open Command Prompt or PowerShell on your Windows machine and type wsl --version, then press Enter. This command shows you which version of Windows Subsystem for Linux you have installed — either WSL 1 or WSL 2 — along with the kernel version number. If the command does not work, you likely have WSL 1, which does not support the --version flag.
If you see an error message instead, WSL may not be installed yet. You can install it by opening PowerShell as administrator and running wsl --install. Windows will read and set up WSL 2 automatically, then prompt you to restart your computer.
The version number matters because WSL 2 runs a real Linux kernel and handles file operations much faster than WSL 1. If you are working with large projects, databases, or Docker containers, WSL 2 will noticeably improve performance. WSL 1 is lighter on system resources but slower for most real work.
Key Takeaways
- Type wsl --version in Command Prompt or PowerShell to see your WSL version and kernel number when ready.
- WSL 2 is faster for file operations and Linux workloads, while WSL 1 uses fewer system resources but runs slower.
- If the command does not work, you have WSL 1 installed, which does not support the version flag.
- You can upgrade from WSL 1 to WSL 2 by running wsl --set-default-version 2 in PowerShell as administrator.
Check which Linux distribution you are running
Knowing your WSL version is only half the picture. You also need to know which Linux distribution is installed inside it — Ubuntu, Debian, Fedora, or another option. Type wsl --list --verbose in Command Prompt or PowerShell to see all distributions on your machine, which version of WSL each one uses, and whether it is set as your default.
The output shows three columns: the distribution name, whether it is running (asterisk means yes), and which WSL version it uses. If you have multiple distributions installed, you can switch between them by typing wsl --set-default [distribution-name]. For example, wsl --set-default Ubuntu makes Ubuntu your default when you open WSL without specifying which one to use.
Upgrade from WSL 1 to WSL 2
If you have WSL 1 and want the speed of WSL 2, the upgrade is straightforward. Open PowerShell as administrator and type wsl --set-default-version 2. This sets WSL 2 as the default for any new distributions you install. Existing WSL 1 distributions stay on version 1 unless you convert them individually.
To convert a specific distribution from WSL 1 to WSL 2, use wsl --set-version [distribution-name] 2. For example, wsl --set-version Ubuntu 2 converts your Ubuntu installation. The conversion takes a few minutes and does not delete your files or settings. After it finishes, that distribution will run on WSL 2 and perform significantly faster, especially when reading and writing files.
Before upgrading, make sure your Windows version supports WSL 2. You need Windows 10 build 19041 or later, or any version of Windows 11. Check your Windows version by pressing Windows key + R, typing winver, and pressing Enter. If you are on an older build, Windows Update will offer the latest version.
Update your WSL kernel
WSL 2 includes a Linux kernel that Windows manages separately from your distribution. Occasionally Microsoft releases kernel updates that fix bugs and improve performance. To update your kernel, open PowerShell as administrator and type wsl --update. Windows downloads and installs the latest kernel, then prompts you to restart WSL.
You can also check for updates manually by typing wsl --update check. If an update is available, run wsl --update to install it. Most updates happen automatically in the background, but checking manually ensures you have the latest version, especially if you have not restarted your computer in a while.
Verify your Linux distribution version
Inside your WSL environment, you can also check which version of your Linux distribution you are running. Open WSL by typing wsl in Command Prompt or PowerShell, then type lsb_release -a. This shows the distribution name, version number, and codename — useful information if you need to troubleshoot compatibility issues or check whether security updates are available.
Different distributions release updates on different schedules. Ubuntu releases new versions every six months and long-term support versions every two years. Debian updates less frequently but focuses on stability. Knowing your distribution version helps you understand which packages are available and whether you need to upgrade to get newer software.
Troubleshoot version check problems
If wsl --version returns an error or does not recognize the command, you likely have an older version of Windows or WSL 1. Try running wsl -l -v instead — this is the older syntax for listing distributions and their versions. If that also fails, WSL may not be installed at all.
If you cannot run PowerShell commands as administrator, right-click PowerShell and select "Run as administrator" from the menu. Some corporate networks or security software block WSL installation or updates. Contact your IT department if you see permission errors when trying to install or update WSL.
After any major Windows update, restart your computer and run wsl --update again. Windows sometimes resets WSL settings during updates, and restarting ensures everything syncs correctly.
Frequently Asked Questions
What is the difference between WSL 1 and WSL 2?
WSL 2 runs a real Linux kernel and is much faster at file operations, especially with large projects. WSL 1 translates Linux commands to Windows and is slower but uses less memory. For development work, Docker, or databases, WSL 2 is the better choice.
Can I have both WSL 1 and WSL 2 distributions at the same time?
Yes. You can install multiple distributions and run some on WSL 1 and others on WSL 2. Use wsl --list --verbose to see which version each one uses, and wsl --set-version [name] 2 to convert any WSL 1 distribution to WSL 2.
Do I lose my files if I upgrade from WSL 1 to WSL 2?
No. Converting a distribution from WSL 1 to WSL 2 preserves all your files, settings, and installed packages. The conversion takes a few minutes but does not delete anything.
How often should I update my WSL kernel?
Most kernel updates happen automatically. Run wsl --update once a month or after a major Windows update to may support you have the latest version. Updates are usually small and install quickly.
Why does wsl --version not work on my computer?
The --version flag only works on WSL 2. If you have WSL 1, use wsl -l -v instead to see your version. You can also upgrade to WSL 2 by running wsl --set-default-version 2 in PowerShell as administrator.