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: getting-started/start_with_WSL.md
+1-25Lines changed: 1 addition & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,31 +34,7 @@ When asked if you want to allow WSL to make changes to your device, click "yes".
34
34
35
35
After WSL has finished installing, you'll need to restart your computer (your physical machine, not just the Terminal window) before you can continue.
36
36
37
-
38
-
## Troubleshooting WSL Failed Installation
39
-
40
-
If the `wsl --install` command does not work for you, especially if it returns the message "This operation timed out", you can debug the issue by following these steps:
41
-
42
-
1. Using your search bar, search for "Turn Windows features on or off" and select it. It'll open a window with some options for you. In this window, you should select the following options:
43
-
* Virtual Machine Platform
44
-
* Windows Subsystem for Linux
45
-
46
-

47
-
48
-
2. After you select these options, open your system's task manager and navigate to the performance tab. You should look for an option that says "virtualisation" to make sure it's enabled. If it isn't enabled, follow this [tutorial to enable it for your system](https://support.microsoft.com/en-us/windows/enable-virtualization-on-windows-11-pcs-c5578302-6e43-4b4b-a449-8ced115f58e1).
49
-

50
-
51
-
3. The next step is to restart your machine and try the `wsl --install` command again. It should work now.
52
-
53
-
4. If you retry the command and it doesn't work as expected, you might see an error that says, "Windows Subsystem for Linux is already installed. The operation timed out". In this case, you should update your WSL version with this command:
54
-
```shell
55
-
wsl.exe --update
56
-
```
57
-
The next step is to set the default WSL version to version 2. Use this command:
58
-
```shell
59
-
wsl --set-default-version 2
60
-
```
61
-
5. Once you have completed the above steps, open your Microsoft Store and search for"Ubuntu". It's advisable to install the latest version. After the installation, you should launch the app. It'll automatically connect to your WSL and you should be able to follow the next steps without errors.
37
+
**NOTE**: If you face issues with installing WSL on your Windows machine, you can refer to our [troubleshooting section](./troubleshooting.md) or the [Windows official documentation for WSL](https://learn.microsoft.com/en-us/windows/wsl/troubleshooting)
This document aims to help you fix issues you're likely to encounter when setting up your machine to contribute to the Ubuntu guides.
4
+
5
+
## Troubleshooting WSL Failed Installation
6
+
7
+
In this section, you'll learn how to troubleshoot the failed installation of Windows Subsystem for Linux (WSL) on your Windows machine. Note that if this method does not solve your specific problem, you can always refer to the [official Windows documentation](https://learn.microsoft.com/en-us/windows/wsl/troubleshooting) to find a fix for your case.
8
+
9
+
10
+
If the `wsl --install` command does not work for you, especially if it returns the message "This operation timed out", you can debug the issue by following these steps:
11
+
12
+
1. Using your search bar, search for "Turn Windows features on or off" and select it. It'll open a window with some options for you. In this window, you should select the following options:
13
+
* Virtual Machine Platform
14
+
* Windows Subsystem for Linux
15
+
16
+

17
+
18
+
2. After you select these options, open your system's task manager and navigate to the performance tab. You should look for an option that says "virtualisation" to make sure it's enabled. If it isn't enabled, follow this [tutorial to enable it for your system](https://support.microsoft.com/en-us/windows/enable-virtualization-on-windows-11-pcs-c5578302-6e43-4b4b-a449-8ced115f58e1).
19
+

20
+
21
+
3. The next step is to restart your machine and try the `wsl --install` command again. It should work now.
22
+
23
+
4. If you retry the command and it doesn't work as expected, you might see an error that says, "Windows Subsystem for Linux is already installed. The operation timed out". In this case, you should update your WSL version with this command:
24
+
```shell
25
+
wsl.exe --update
26
+
```
27
+
The next step is to set the default WSL version to version 2. Use this command:
28
+
```shell
29
+
wsl --set-default-version 2
30
+
```
31
+
5. Once you have completed the above steps, open your Microsoft Store and search for"Ubuntu". It's advisable to install the latest version. After the installation, you should launch the app. It'll automatically connect to your WSL and you should be able to follow the [next steps](./start_with_WSL.md) without errors.
0 commit comments