Skip to content

Commit 6098a69

Browse files
Remove obsolete Win10 1903/legacy WSL sections; fix wsl --version references
* Remove obsolete Win10 1903 section and legacy WSL uninstall; fix wsl --version - Remove 'I'm on Windows 10 version 1903' section — Win10 1903 reached EOL December 2020; the backport KB is no longer relevant - Remove 'Uninstall legacy version of WSL' section — targeted Windows 10 pre-Creators Update (Oct 2017, Build 16299), which is years past EOL - Fix wsl.exe -v -> wsl --version in bug report template for consistency with current WSL documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address Copilot review feedback: wsl --version fallback, lsb_release fix, remove lxrun - Add wsl.exe --status fallback for inbox WSL users in bug report template (wsl --version requires Store WSL) - Fix 'run lsb_release -r' → 'lsb_release -r' (spurious 'run' prefix) - Replace lxrun /setdefaultuser with wsl -u root in older-versions section - Replace lxrun /uninstall /full with wsl --unregister in system restore section Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 2b634ec commit 6098a69

1 file changed

Lines changed: 6 additions & 16 deletions

File tree

WSL/troubleshooting.md

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Troubleshooting Windows Subsystem for Linux
33
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
55
ms.topic: troubleshooting-general
66
---
77

@@ -25,10 +25,10 @@ The [WSL product repo issues](https://github.com/microsoft/WSL/issues) enables y
2525

2626
- Issue Title
2727
- 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.
2929
- 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`.
3030
- 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`.
3232
- Other Software: If you're reporting a bug involving WSL's interaction with other applications, please tell us. What applications? What versions?
3333
- Repro Steps: Please list out the steps to reproduce your bug.
3434
- Expected Behavior: What were you expecting to see? Include any relevant examples or documentation links.
@@ -105,12 +105,6 @@ You can also:
105105
106106
## Common issues
107107
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-
114108
### Error: 0x1bc when `wsl --set-default-version 2`
115109
116110
This may happen when 'Display Language' or 'System Locale' setting is not English.
@@ -690,8 +684,8 @@ sudo update-locale LANG=en_US.UTF8
690684

691685
2. Enable the WSL optional feature (if not already)
692686
3. Reboot
693-
4. lxrun /uninstall /full
694-
5. Install bash
687+
4. Run `wsl --unregister <DistroName>` to remove the legacy WSL distribution (for older legacy WSL, `lxrun /uninstall /full` was used)
688+
5. Reinstall the Linux distribution from the Microsoft Store
695689

696690
### No internet access in WSL
697691

@@ -871,11 +865,7 @@ Interoperability command differences:
871865
- To see what commands are available for a particular distribution, run `[distro.exe] /?`. For example, with Ubuntu: `C:\> ubuntu.exe /?`.
872866
- Windows path is included in the WSL `$PATH`.
873867
- 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 command in 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.
879869

880870
## Error code 0x8000FFFF unexpected failure
881871

0 commit comments

Comments
 (0)