Skip to content

Commit c676af5

Browse files
Updated install win10.md instructions
1 parent c782d34 commit c676af5

1 file changed

Lines changed: 21 additions & 27 deletions

File tree

WSL/install-win10.md

Lines changed: 21 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -15,47 +15,38 @@ Before installing any Linux distros for WSL, you must ensure that the "Windows S
1515
Open PowerShell as Administrator and run:
1616

1717
```powershell
18-
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
18+
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
1919
```
2020

21-
**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)**
2522

2623
## Install the Windows Subsystem for Linux 2
2724

28-
To install and start using WSL 2 complete the following steps:
25+
To use WSL 2 please ensure you meet the following criteria:
2926

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
3228
- 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.
3730

38-
## Enable the 'Virtual Machine Platform' optional component
31+
### Enable the 'Virtual Machine Platform' optional component
3932

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:
4134

4235
```powershell
4336
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
4437
```
4538

46-
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.
4940

50-
To download and install your preferred distro(s), you have three choices:
41+
### Set WSL 2 as your default version
5142

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:
5544

56-
### Windows 10 Fall Creators Update and later: Install from the Microsoft Store
45+
```powershell
46+
wsl --set-default-version 2
47+
```
5748

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
5950

6051
1. Open the Microsoft Store and choose your favorite Linux distribution.
6152

@@ -84,9 +75,6 @@ To download and install your preferred distro(s), you have three choices:
8475

8576
After launching your Linux distribution, follow the onscreen instructions to initialize your distro.
8677

87-
> [!NOTE]
88-
> For Windows Server, launch your distribution using the executable, `<distro>.exe`, in the installation folder.
89-
9078
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.
9179

9280
### Set up a new Linux user account
@@ -109,7 +97,13 @@ sudo apt update && sudo apt upgrade
10997

11098
Windows does not automatically update or upgrade your Linux distro(s). This is a task that the most Linux users prefer to control themselves.
11199

112-
## Set a distro to be backed by WSL1 or WSL2 using the command line
100+
## Further Resources
101+
102+
You're now set up and ready to start using the Windows Subsystem for Linux!
103+
104+
If you'd like to learn more about managing WSL please read on below.
105+
106+
### Set a distro to be backed by WSL1 or WSL2 using the command line
113107

114108
To set a distro to be backed by either version of WSL please run:
115109

0 commit comments

Comments
 (0)