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
+35Lines changed: 35 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,6 +36,41 @@ Lastly, if your issue is related to the Windows Terminal, Windows Console, or th
36
36
37
37
## Common issues
38
38
39
+
### Cannot access WSL files from Windows
40
+
A 9p protocol file server provides the service on the Linux side to allow Windows to access the Linux file system. If you cannot access WSL using `\\wsl$` on Windows, it could be because 9P did not start correctly.
41
+
42
+
To check this, you can check the start up logs using: `dmesg |grep 9p`, and this will show you any errors. A successfull output looks like the following:
43
+
44
+
```
45
+
[ 0.363323] 9p: Installing v9fs 9p2000 file system support
46
+
[ 0.363336] FS-Cache: Netfs '9p' registered for caching
47
+
[ 0.398989] 9pnet: Installing 9P2000 support
48
+
```
49
+
50
+
Please see [this Github thread](https://github.com/microsoft/wsl/issues/5307) for further discussion on this issue.
51
+
52
+
### Can't start WSL 2 distro and only see 'WSL 2' in output
53
+
If your display language is not English, then it is possible you are seeing a truncated version of an error text.
54
+
55
+
```powershell
56
+
C:\Users\me>wsl
57
+
WSL 2
58
+
```
59
+
60
+
To resolve this issue, please visit `https://aka.ms/wsl2kernel` and install the kernel manually by following the directions on that doc page.
61
+
62
+
### Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.
63
+
64
+
1. Check the [Hyper-V system requirements](https://docs.microsoft.com/windows-server/virtualization/hyper-v/system-requirements-for-hyper-v-on-windows#:~:text=on%20Windows%20Server.-,General%20requirements,the%20processor%20must%20have%20SLAT.)
65
+
2. If your machine is a VM, please enable [nested virtualization](https://docs.microsoft.com/windows/wsl/wsl2-faq#can-i-run-wsl-2-in-a-virtual-machine) manually. Launch powershell with admin, and run:
3. Please follow guidelines from your PC's manufacturer on how to enable virtualization. In general, this can involve using the system BIOS to ensure that these features are enabled on your CPU.
72
+
4. Restart your machine after enabling the `Virtual Machine Platform` optional component.
73
+
39
74
### Bash loses network connectivity once connected to a VPN
40
75
41
76
If after connecting to a VPN on Windows, bash loses network connectivity, try this workaround from within bash. This workaround will allow you to manually override the DNS resolution through `/etc/resolv.conf`.
Copy file name to clipboardExpand all lines: WSL/wsl2-kernel.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,3 +34,24 @@ To install the Linux kernel update package:
34
34
## Future plans for updating the WSL2 Linux kernel
35
35
36
36
For more information, read the article [changes to updating the WSL2 Linux kernel](https://devblogs.microsoft.com/commandline/wsl2-will-be-generally-available-in-windows-10-version-2004), available on the [Windows Command Line Blog](https://aka.ms/cliblog).
37
+
38
+
## Troubleshooting
39
+
40
+
### This update only applies to machines with the Windows Subsystem for Linux
41
+
To install MSI kernel, WSL is required and should be enabled first. If it fails, it you will see the message:
42
+
`This update only applies to machines with the Windows Subsytem for Linux`.
43
+
44
+
There are three possible reason you see this message:
45
+
46
+
1. You are still in old version of Windows which doesn't support WSL 2. Please check the [WSL 2 requirements](https://docs.microsoft.com/windows/wsl/install-win10#update-to-wsl-2) and upgrade to use WSL 2.
47
+
2.`Windows Subsystem for Linux` is not enabled. Please follow the [Windows Subsystem for Linux Installation Guide](https://docs.microsoft.com/windows/wsl/install-win10).
48
+
3. After you enabled `Windows Subsystem for Linux`, a reboot is required to take into effect, please reboot your machine and try again.
49
+
50
+
### `WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel`
51
+
52
+
Each time kernel is missing in %SystemRoot%\system32\lxss\tools\, you may run into the above error.
53
+
54
+
Here are some possible ways to resolve it:
55
+
56
+
1. Please install the Linux kernel manually by following the instructions at: https://aka.ms/wsl2kernel
57
+
2. Uninstall the MSI from 'Add or Remove Programs', and install it again
0 commit comments