You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: WSL/troubleshooting.md
+6-16Lines changed: 6 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Troubleshooting Windows Subsystem for Linux
3
3
description: Provides detailed information about common errors and issues people run into while running Linux on the Windows Subsystem for Linux.
4
-
ms.date: 10/03/2025
4
+
ms.date: 04/15/2026
5
5
ms.topic: troubleshooting-general
6
6
---
7
7
@@ -25,10 +25,10 @@ The [WSL product repo issues](https://github.com/microsoft/WSL/issues) enables y
25
25
26
26
- Issue Title
27
27
- Windows Version: Please run `cmd.exe /c ver` to get the build of Windows you are on.
28
-
- WSL Version: If you are running Windows Subsystem for Linux from the Microsoft Store, please run `wsl.exe -v`.
28
+
- WSL Version: Run `wsl --version` to get your WSL version. On older (inbox) WSL builds, run `wsl.exe --status` instead.
29
29
- Are you using WSL 1 or WSL 2: Tell us whether the issue is on WSL 2 and/or WSL 1. You can tell by running `wsl.exe -l -v`.
30
30
- Kernel Version: Please tell us what version of the Linux kernel you are using, or if you are using a custom kernel. You can run `wsl.exe --status` if that command is available to you, or by running `cat /proc/version` in your distro.
31
-
- Distro Version: Please tell us what distro you are using (if applicable). You can get additional information about the version where possible, e.g. on Debian / Ubuntu, `run lsb_release -r`.
31
+
- Distro Version: Please tell us what distro you are using (if applicable). You can get additional information about the version where possible, e.g. on Debian / Ubuntu, `lsb_release -r`.
32
32
- Other Software: If you're reporting a bug involving WSL's interaction with other applications, please tell us. What applications? What versions?
33
33
- Repro Steps: Please list out the steps to reproduce your bug.
34
34
- Expected Behavior: What were you expecting to see? Include any relevant examples or documentation links.
@@ -105,12 +105,6 @@ You can also:
105
105
106
106
## Common issues
107
107
108
-
### I'm on Windows 10 version 1903 and I still do not see options for WSL 2
109
-
110
-
This is likely because your machine has not yet taken the backport for WSL 2. The simplest way to resolve this is by going to [Windows Settings](ms-settings:windowsupdate) and clicking "**Check for Updates**" to install the latest updates on your system. See [the full instructions on taking the backport](https://devblogs.microsoft.com/commandline/wsl-2-support-is-coming-to-windows-10-versions-1903-and-1909/#how-do-i-get-it).
111
-
112
-
If you hit "**Check for Updates**" and still do not receive the update you can [install KB KB4566116 manually](https://catalog.update.microsoft.com/Search.aspx?q=KB4566116).
113
-
114
108
### Error: 0x1bc when `wsl --set-default-version 2`
115
109
116
110
This may happen when 'Display Language' or 'System Locale' setting is not English.
- To see what commands are available for a particular distribution, run `[distro.exe] /?`. For example, with Ubuntu: `C:\> ubuntu.exe /?`.
872
866
- Windows path is included in the WSL `$PATH`.
873
867
- When calling a Windows tool from a WSL distribution in an earlier version of Windows 10, you will need to specify the directory path. For example, to call the Windows Notepad app from your WSL command line, enter: `/mnt/c/Windows/System32/notepad.exe`
874
-
- To change the default user to `root` use this commandin PowerShell: `C:\> lxrun /setdefaultuser root` and then run Bash.exe to log in: `C:\> bash.exe`. Reset your password using the distributions password command: `$ passwd username` and then close the Linux command line: `$ exit`. From Windows command prompt or Powershell, reset your default user back to your normal Linux user account: `C:\> lxrun.exe /setdefaultuser username`.
875
-
876
-
## Uninstall legacy version of WSL
877
-
878
-
If you originally installed WSL on a version of Windows 10 prior to Creators update (Oct 2017, Build 16299), we recommend that you migrate any necessary files, data, etc. from the older Linux distribution you installed, to a newer distribution installed via the Microsoft Store. To remove the legacy distribution from your machine, run the following from a Command Line or PowerShell instance: `wsl --unregister Legacy`. You also have the option to manually remove the older legacy distribution by deleting the `%LocalAppData%\lxss\` folder (and all it's sub-contents) using Windows File Explorer or with PowerShell: `Remove-Item -Recurse $env:localappdata/lxss/`.
868
+
- To run a command as `root`for early versions, use `C:\> bash.exe -c "su -"`. On supported Windows versions, use `wsl -u root` instead.
0 commit comments