Skip to content

Commit 3e03da3

Browse files
Update to install steps (#1017)
Updated install-win10.md to include --install instructions Co-authored-by: Craig Loewen <[email protected]>
1 parent 42eff29 commit 3e03da3

1 file changed

Lines changed: 40 additions & 14 deletions

File tree

WSL/install-win10.md

Lines changed: 40 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,19 @@ ms.localizationpriority: high
99

1010
# Windows Subsystem for Linux Installation Guide for Windows 10
1111

12-
## Install Windows Subsystem for Linux
12+
There are two options available for installing Windows Subsystem for Linux (WSL):
1313

14-
Windows Subsystem for Linux has two different versions to choose between during the installation process. WSL 2 has better overall performance and we recommend using it. If your system does not support WSL 2, or you have a specific situation that requires cross-system file storage, then you may want to stick with WSL 1. Read more about [Comparing WSL 2 and WSL 1](./compare-versions.md).
14+
- **[Simplified install](#simplified-installation-for-windows-insiders)** *(preview release)*: `wsl --install`
1515

16-
> [!NOTE]
17-
> To use the new `wsl --install` command and skip steps 1-6 below, you need to join the [Windows Insiders Program](https://insider.windows.com/getting-started) and install a preview build of Windows 10 (OS build 20262 or higher).
18-
>
19-
> Once the preview build is installed, you can open a command prompt window with administrator privileges and run `wsl --install`. This will automatically enable the optional WSL and Virtual Machine Platform components, download and install the latest Linux kernel, set WSL 2 as the default, and download Ubuntu (this can be changed using `wsl --install -d Debian` as an example, to see a list of available Linux distributions, enter `wsl --list --online`). Once the command has completed, you will be prompted to restart. After restarting, the Linux distribution (Ubuntu by default) completes installing and opens a Linux command line for you to begin using. You could then skip to [Step 7 - Set up a new distribution](./install-win10.md#step-7---set-up-a-new-distribution).
16+
The `wsl --install` simplified install command requires that you join the [Windows Insiders Program](https://insider.windows.com/getting-started) and install a preview build of Windows 10 (OS build 20262 or higher), but eliminates the need to follow the manual install steps. All you need to do is open a command window with administrator privileges and run `wsl --install`, after a restart you will be ready to use WSL. [Click here to learn more about this command](#simplified-installation-for-windows-insiders).
17+
18+
- **[Manual install](#manual-installation-steps)**: Follow the six steps listed below.
2019

21-
### Install Steps
20+
The manual install steps for WSL are listed below and can be used to install Linux on any version of Windows 10.
2221

23-
- Open a command window with Administrator privileges
24-
- Run `wsl.exe --install`
25-
- Restart your machine if necessary and directed by the command
26-
- Upon restart your installation will finish and you'll be ready to start using WSL!
22+
## Manual Installation Steps
2723

28-
This will install the Ubuntu distribution. You can also install other distributions by passing in arguments, for example `wsl --install -d Debian` will install Debian. Running `wsl --list --online` will show you a list of available distributions.
24+
If you are not on a Windows Insiders build, the features required for WSL will need to be enabled manually following the steps below.
2925

3026
## Step 1 - Enable the Windows Subsystem for Linux
3127

@@ -121,8 +117,6 @@ wsl --set-default-version 2
121117

122118
![Linux distributions in the Microsoft store](media/UbuntuStore.png)
123119

124-
## Step 7 - Set up a new distribution
125-
126120
The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. All future launches should take less than a second.
127121

128122
You will then need to [create a user account and password for your new Linux distribution](./user-support.md).
@@ -131,6 +125,38 @@ You will then need to [create a user account and password for your new Linux dis
131125

132126
**CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!**
133127

128+
## Simplified Installation for Windows Insiders
129+
130+
The installation process for Windows Subsystem for Linux has been significantly improved in the latest Windows Insiders preview builds of Windows 10, replacing the manual steps below with a single command.
131+
132+
In order to use the `wsl --install` simplified install command, you must:
133+
134+
- Join the [Windows Insiders Program](https://insider.windows.com/getting-started)
135+
- Install a preview build of Windows 10 (OS build 20262 or higher).
136+
- Open a command line windows with Administrator privileges
137+
138+
Once those requirements are met, to install WSL:
139+
140+
- Enter this command in the command line you've opened in Admin mode: `wsl.exe --install`
141+
- Restart your machine
142+
143+
The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for files to de-compress and be stored on your PC. All future launches should take less than a second.
144+
145+
You will then need to [create a user account and password for your new Linux distribution](./user-support.md).
146+
147+
**CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!**
148+
149+
The --install command performs the following actions:
150+
151+
- Enables the optional WSL and Virtual Machine Platform components
152+
- Downloads and installs the latest Linux kernel
153+
- Sets WSL 2 as the default
154+
- Downloads and installs a Linux distribution *(reboot may be required)*
155+
156+
By default, the installed Linux distribution will be Ubuntu. This can be changed using `wsl --install -d <Distribution Name>`. *(Replacing `<Distribution Name>` with the name of your desired distribution.)* Additional Linux distributions may be added to your machine after the initial install using the `wsl --install -d <Distribution Name>` command.
157+
158+
To see a list of available Linux distributions, enter `wsl --list --online`.
159+
134160
## Install Windows Terminal (optional)
135161

136162
Windows Terminal enables multiple tabs (quickly switch between multiple Linux command lines, Windows Command Prompt, PowerShell, Azure CLI, etc), create custom key bindings (shortcut keys for opening or closing tabs, copy+paste, etc.), use the search feature, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). [Learn more.](/windows/terminal)

0 commit comments

Comments
 (0)