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
**If you're looking for 100% system call compatibility and faster IO performance, read below to install WSL 2!**
22
-
> WSL 2 is only available in Windows 10 builds 18917 or higher
23
-
24
-
**If continuing with WSL 1, restart your machine when prompted and continue with installation [here](./install-win10.md#install-your-linux-distribution-of-choice)**
21
+
**If you would like to only install WSL 1, please restart your machine and then continue with installation [here](./install-win10.md#install-your-linux-distribution-of-choice)**
25
22
26
23
## Install the Windows Subsystem for Linux 2
27
24
28
-
To install and start using WSL 2 complete the following steps:
25
+
To use WSL 2 please ensure you meet the following criteria:
29
26
30
-
1. Ensure that you are running Windows 10 **build 18917** or higher
31
-
- To make sure you are using build 18917 or higher please join [the Windows Insider Program](https://insider.windows.com/) and select the 'Fast' ring or the 'Slow' ring.
27
+
- Ensure that you are running Windows 10 **build 18917** or higher
32
28
- You can check your Windows version by opening Command Prompt and running the `ver` command.
33
-
2. Enable the 'Virtual Machine Platform' optional component
34
-
3. Install a Linux distribution of your choice
35
-
4. Set a distro to be backed by WSL1 or WSL2 using the command line
36
-
5. Verify what versions of WSL your distros are using
29
+
- Please update to the latest Windows version if your build is lower than 18917.
37
30
38
-
## Enable the 'Virtual Machine Platform' optional component
31
+
###Enable the 'Virtual Machine Platform' optional component
39
32
40
-
For WSL 2, you will also need to make sure that you have the Virtual Machine Platform optional component installed. You can do that by running the following command in PowerShell:
33
+
For WSL 2, you will also need to make sure that you have the Virtual Machine Platform optional component installed. You can do that by running the following command in a PowerShell window with administrator access:
Please restart your machine to finish installing both components.
47
-
48
-
## Install your Linux distribution of choice
39
+
Please **restart** your machine to finish installing these components.
49
40
50
-
To download and install your preferred distro(s), you have three choices:
41
+
### Set WSL 2 as your default version
51
42
52
-
- Download and install from the Microsoft Store (see below)
53
-
- Download and install from the Command-Line/Script ([read the manual installation instructions](install-manual.md))
54
-
- Download and manually unpack and install (for Windows Server - [instructions here](install-on-server.md))
43
+
Run the following command in Powershell to set WSL 2 as your default:
55
44
56
-
### Windows 10 Fall Creators Update and later: Install from the Microsoft Store
45
+
```powershell
46
+
wsl --set-default-version 2
47
+
```
57
48
58
-
> This section is for Windows build 16215 or later. Follow these steps to [check your build](troubleshooting.md#check-your-build-number).
49
+
## Install your Linux distribution of choice
59
50
60
51
1. Open the Microsoft Store and choose your favorite Linux distribution.
61
52
@@ -84,9 +75,6 @@ To download and install your preferred distro(s), you have three choices:
84
75
85
76
After launching your Linux distribution, follow the onscreen instructions to initialize your distro.
86
77
87
-
> [!NOTE]
88
-
> For Windows Server, launch your distribution using the executable, `<distro>.exe`, in the installation folder.
89
-
90
78
The first time a newly installed distribution runs, a console window will open and you'll be asked to wait for a minute or two for the installation to complete. During this final stage of installation, the distro's files are de-compressed and stored on your PC, ready for use. This may take around a minute or more depending on the performance of your PC's storage devices. This initial installation phase is only required when a distro is clean-installed - all future launches should take less than a second.
0 commit comments