Skip to content

Commit 1b61913

Browse files
authored
Merge pull request #675 from MicrosoftDocs/master
Update Build #, add Insider note
2 parents eaeb3de + 050808c commit 1b61913

5 files changed

Lines changed: 26 additions & 20 deletions

File tree

WSL/compare-versions.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,9 @@ Feature | WSL 1 | WSL 2
2626
Runs with VM Ware and VirtualBox| ✅ |❌
2727
Performance across OS file systems| ✅ | ❌
2828

29-
Already using WSL 1 and want to upgrade to WSL 2? Follow the instructions to [update to WSL 2](./install-win10.md#update-to-wsl-2)! WSL 2 is only available in Windows 10 builds 18917 or higher, so you may need to [update to the latest Windows version](ms-settings:windowsupdate).
29+
Already using WSL 1 and want to upgrade to WSL 2? Follow the instructions to [update to WSL 2](./install-win10.md#update-to-wsl-2)!
30+
31+
WSL 2 is only available in Windows 10, Version 2004, Build 19041 or higher. You will need to [update your Windows version](ms-settings:windowsupdate) and [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) on the "Release Preview" ring until the public release in late May.
3032

3133
## Use the Linux file system for faster performance
3234

WSL/install-on-server.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@ Open PowerShell as Administrator and run:
2323
```
2424

2525
**If you're looking for 100% system call compatibility and faster IO performance, read below to install WSL 2!**
26-
> WSL 2 is only available in Windows 10 builds 18917 or higher
26+
27+
WSL 2 is only available in Windows 10, Version 2004, Build 19041 or higher. You will need to [update your Windows version](ms-settings:windowsupdate) and [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) on the "Release Preview" ring until the public release in late May.
2728

2829
**If continuing with WSL 1, restart your machine when prompted and continue with installation [here](./install-on-server.md#download-a-linux-distribution)**
2930

WSL/install-win10.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ To update to WSL 2, you must meet the follow criteria:
2727

2828
- Running Windows 10, [updated to version 2004](ms-settings:windowsupdate), **Build 19041** or higher.
2929

30+
> [!IMPORTANT]
31+
> Currently to update to Windows 10, version 2004 (Build 19041), you will need to [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) and select the "Release Preview" ring. The public release should arrive by late May.
32+
3033
- Check your Windows version by selecting the **Windows logo key + R**, type **winver**, select **OK**. (Or enter the `ver` command in Windows Command Prompt). Please [update to the latest Windows version](ms-settings:windowsupdate) if your build is lower than 19041. [Get Windows Update Assistant](https://www.microsoft.com/software-download/windows10).
3134

3235
### Enable the 'Virtual Machine Platform' optional component
@@ -57,20 +60,20 @@ wsl --set-default-version 2
5760

5861
The following links will open the Microsoft store page for each distribution:
5962

60-
* [Ubuntu](https://www.microsoft.com/store/apps/9NBLGGH4MSV6)
61-
* [Ubuntu 16.04 LTS](https://www.microsoft.com/store/apps/9pjn388hp8c9)
62-
* [Ubuntu 18.04 LTS](https://www.microsoft.com/store/apps/9N9TNGVNDL3Q)
63-
* [Ubuntu 20.04 LTS](https://www.microsoft.com/store/apps/9N6SVWS3RX71)
64-
* [OpenSUSE Leap 15](https://www.microsoft.com/store/apps/9n1tb6fpvj8c)
65-
* [OpenSUSE Leap 42](https://www.microsoft.com/store/apps/9njvjts82tjx)
66-
* [SUSE Linux Enterprise Server 12](https://www.microsoft.com/store/apps/9p32mwbh6cns)
67-
* [SUSE Linux Enterprise Server 15](https://www.microsoft.com/store/apps/9pmw35d7fnlx)
68-
* [Kali Linux](https://www.microsoft.com/store/apps/9PKR34TNCV07)
69-
* [Debian GNU/Linux](https://www.microsoft.com/store/apps/9MSVKQC78PK6)
70-
* [Fedora Remix for WSL](https://www.microsoft.com/store/apps/9n6gdm4k2hnc)
71-
* [Pengwin](https://www.microsoft.com/store/apps/9NV1GV1PXZ6P)
72-
* [Pengwin Enterprise](https://www.microsoft.com/store/apps/9N8LP0X93VCP)
73-
* [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395)
63+
- [Ubuntu](https://www.microsoft.com/store/apps/9NBLGGH4MSV6)
64+
- [Ubuntu 16.04 LTS](https://www.microsoft.com/store/apps/9pjn388hp8c9)
65+
- [Ubuntu 18.04 LTS](https://www.microsoft.com/store/apps/9N9TNGVNDL3Q)
66+
- [Ubuntu 20.04 LTS](https://www.microsoft.com/store/apps/9N6SVWS3RX71)
67+
- [OpenSUSE Leap 15](https://www.microsoft.com/store/apps/9n1tb6fpvj8c)
68+
- [OpenSUSE Leap 42](https://www.microsoft.com/store/apps/9njvjts82tjx)
69+
- [SUSE Linux Enterprise Server 12](https://www.microsoft.com/store/apps/9p32mwbh6cns)
70+
- [SUSE Linux Enterprise Server 15](https://www.microsoft.com/store/apps/9pmw35d7fnlx)
71+
- [Kali Linux](https://www.microsoft.com/store/apps/9PKR34TNCV07)
72+
- [Debian GNU/Linux](https://www.microsoft.com/store/apps/9MSVKQC78PK6)
73+
- [Fedora Remix for WSL](https://www.microsoft.com/store/apps/9n6gdm4k2hnc)
74+
- [Pengwin](https://www.microsoft.com/store/apps/9NV1GV1PXZ6P)
75+
- [Pengwin Enterprise](https://www.microsoft.com/store/apps/9N8LP0X93VCP)
76+
- [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395)
7477

7578
2. From the distribution's page, select "Get".
7679

@@ -86,7 +89,7 @@ You will then need to [create a user account and password for your new Linux dis
8689

8790
## Set your distribution version to WSL 1 or WSL 2
8891

89-
You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18917 or higher): `wsl -l -v`
92+
You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in [Windows Build 19041 or higher](ms-settings:windowsupdate)): `wsl -l -v`
9093

9194
```bash
9295
wsl --list --verbose
@@ -125,7 +128,7 @@ Below are related errors and suggested fixes. Refer to the [WSL troubleshooting
125128
- Please make sure that virtualization is enabled inside of your computer's BIOS. The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
126129

127130
- **Error when trying to upgrade: `Invalid command line option: wsl --set-version Ubuntu 2`**
128-
- Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18917 or higher. To enable WSL run this command in a Powershell prompt with admin privileges: `Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux`. You can find the full WSL install instructions [here](./install-win10.md).
131+
- Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 19041 or higher. To enable WSL run this command in a Powershell prompt with admin privileges: `Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux`. You can find the full WSL install instructions [here](./install-win10.md).
129132

130133
- **The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.**
131134
- Please check [WSL Github thread #4103](https://github.com/microsoft/WSL/issues/4103) where this issue is being tracked for updated information.

WSL/reference.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ wsl --set-default-version 2
2222

2323
## Set your distribution version to WSL 1 or WSL 2
2424

25-
You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18917 or higher): `wsl -l -v`
25+
You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in [Windows Build 19041 or higher](ms-settings:windowsupdate)): `wsl -l -v`
2626

2727
```bash
2828
wsl --list --verbose

WSL/wsl2-index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.localizationpriority: high
1111

1212
WSL 2 is a new version of the architecture in WSL that changes how Linux distributions interact with Windows. WSL 2 has the primary goals of increasing file system performance and adding full system call compatibility. Each Linux distribution can run as WSL 1 or a WSL 2 and can be switched between at any time. WSL 2 is a major overhaul of the underlying architecture and uses virtualization technology and a Linux kernel to enable its new features.
1313

14-
> WSL 2 is only available in Windows 10 builds 18917 or higher.
14+
WSL 2 is only available in Windows 10, Version 2004, Build 19041 or higher. You will need to [update your Windows version](ms-settings:windowsupdate) and [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) on the "Release Preview" ring until the public release in late May.
1515

1616
[Update from WSL 1 to WSL 2](./install-win10.md#update-to-wsl-2)
1717

0 commit comments

Comments
 (0)