Skip to content

Commit d000ce2

Browse files
Merge pull request #2518 from GrantMeStrength/jken/install-manual-fixes
Fix EOL distros, SUSE nesting, and curl example in install-manual
2 parents d674947 + 0070024 commit d000ce2

1 file changed

Lines changed: 20 additions & 23 deletions

File tree

WSL/install-manual.md

Lines changed: 20 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Manual installation steps for older versions of WSL
33
description: Step by step instructions to manually install WSL on older versions of Windows, rather than using the wsl install command.
44
keywords: wsl, install, BashOnWindows, bash, windows subsystem for linux, install ubuntu on windows, enable WSL2, linux on windows
5-
ms.date: 06/08/2025
5+
ms.date: 04/15/2026
66
ms.topic: article
77
adobe-target: true
88
---
@@ -192,34 +192,31 @@ If the Microsoft Store app is not available, you can download and manually insta
192192
- [Ubuntu 24.04 LTS](https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2404-240425.AppxBundle) (x64, arm64)
193193
- [Ubuntu 22.04 LTS](https://aka.ms/wslubuntu2204) (x64, arm64)
194194
- [Ubuntu 20.04 LTS](https://aka.ms/wslubuntu2004) (x64, arm64)
195-
- [Ubuntu 18.04 LTS](https://aka.ms/wsl-ubuntu-1804) (x64)
196-
- [Ubuntu 18.04 LTS ARM](https://aka.ms/wsl-ubuntu-1804-arm) (arm64)
197-
- [Ubuntu 16.04](https://aka.ms/wsl-ubuntu-1604) (x64)
198195
- Debian:
199196
- [Debian GNU/Linux](https://aka.ms/wsl-debian-gnulinux) (x64, arm64)
200197
- Kali Linux:
201198
- [Kali Linux Rolling](https://aka.ms/wsl-kali-linux-new)
202-
- OracleLinux:
199+
- Oracle Linux:
203200
- [Oracle Linux 9.1](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/OracleLinux_9.1-230428.Appx) (x64)
204201
- [Oracle Linux 8.7](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/OracleLinux_8.7-230428.Appx) (x64)
205202
- [Oracle Linux 8.5](https://aka.ms/wsl-oraclelinux-8-5) (x64)
206203
- [Oracle Linux 7.9](https://aka.ms/wsl-oraclelinux-7-9) (x64)
207-
- SUSE:
208-
- openSUSE:
209-
- [openSUSE Tumbleweed](https://aka.ms/wsl-opensuse-tumbleweed) (x64)
210-
- [openSUSE Leap 15.6](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/SUSELeap15p6-240801_x64.Appx) (x64)
211-
- [openSUSE Leap 15.3](https://aka.ms/wsl-opensuseleap15-3) (x64)
212-
- [openSUSE Leap 15.2](https://aka.ms/wsl-opensuseleap15-2) (x64)
213-
- SUSE Linux:
214-
- [SUSE Linux Enterprise Server 15 SP6](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/SUSELinuxEnterprise15SP6-241001_x64.Appx) (x64)
215-
- [SUSE Linux Enterprise Server 15 SP5](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/SUSELinuxEnterprise15_SP5-240801.Appx) (x64)
216-
- [SUSE Linux Enterprise Server 15 SP3](https://aka.ms/wsl-SUSELinuxEnterpriseServer15SP3) (x64)
217-
- [SUSE Linux Enterprise Server 15 SP2](https://aka.ms/wsl-SUSELinuxEnterpriseServer15SP2) (x64)
218-
- [SUSE Linux Enterprise Server 12](https://aka.ms/wsl-sles-12) (x64)
204+
- SUSE:
205+
- openSUSE:
206+
- [openSUSE Tumbleweed](https://aka.ms/wsl-opensuse-tumbleweed) (x64)
207+
- [openSUSE Leap 15.6](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/SUSELeap15p6-240801_x64.Appx) (x64)
208+
- [openSUSE Leap 15.3](https://aka.ms/wsl-opensuseleap15-3) (x64)
209+
- [openSUSE Leap 15.2](https://aka.ms/wsl-opensuseleap15-2) (x64)
210+
- SUSE Linux:
211+
- [SUSE Linux Enterprise Server 15 SP6](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/SUSELinuxEnterprise15SP6-241001_x64.Appx) (x64)
212+
- [SUSE Linux Enterprise Server 15 SP5](https://publicwsldistros.blob.core.windows.net/wsldistrostorage/SUSELinuxEnterprise15_SP5-240801.Appx) (x64)
213+
- [SUSE Linux Enterprise Server 15 SP3](https://aka.ms/wsl-SUSELinuxEnterpriseServer15SP3) (x64)
214+
- [SUSE Linux Enterprise Server 15 SP2](https://aka.ms/wsl-SUSELinuxEnterpriseServer15SP2) (x64)
215+
- [SUSE Linux Enterprise Server 12](https://aka.ms/wsl-sles-12) (x64)
219216
- Fedora Remix:
220217
- [Fedora Remix for WSL](https://github.com/WhitewaterFoundry/Fedora-Remix-for-WSL/releases) (x64, arm64)
221218

222-
This will cause the `<distro>.appx` packages to download to a folder of your choosing.
219+
This will cause the `.appx` or `.AppxBundle` packages to download to a folder of your choosing.
223220

224221
If you prefer, you can also download your preferred distribution(s) via the command line, you can use PowerShell with the [Invoke-WebRequest](/powershell/module/microsoft.powershell.utility/invoke-webrequest) cmdlet. For example, to download Ubuntu 20.04:
225222

@@ -230,25 +227,25 @@ Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBas
230227
> [!TIP]
231228
> If the download is taking a long time, turn off the progress bar by setting `$ProgressPreference = 'SilentlyContinue'`
232229
233-
You also have the option to use the [curl command-line utility](https://curl.se/) for downloading. To download Ubuntu 20.04 with curl:
230+
You also have the option to use the [curl command-line utility](https://curl.se/) for downloading. To download Ubuntu 24.04 LTS with curl:
234231

235232
```powershell
236-
curl.exe -LR -o ubuntu-2004.Appx https://aka.ms/wslubuntu2204
233+
curl.exe -LR -o ubuntu-2404.AppxBundle https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2404-240425.AppxBundle
237234
```
238235

239236
In this example, `curl.exe` is executed (not just `curl`) to ensure that, in PowerShell, the real curl executable is invoked, not the PowerShell curl alias for [Invoke-WebRequest](/powershell/module/microsoft.powershell.utility/invoke-webrequest).
240237

241-
### Installing the Appx package with Add-AppxPackage
238+
### Installing the package with Add-AppxPackage
242239

243240
**Note** The following command won't work on Server Core installations
244241

245-
Once the distribution has been downloaded, navigate to the folder containing the download and run the following command in that directory, where `app-name` is the name of the Linux distribution .appx file.
242+
Once the distribution has been downloaded, navigate to the folder containing the download and run the following command in that directory, where `app-name` is the name of the Linux distribution `.appx` or `.AppxBundle` file.
246243

247244
```powershell
248245
Add-AppxPackage .\app_name.Appx
249246
```
250247

251-
Once the Appx package has finished downloading, you can start running the new distribution by double-clicking the appx file. (The command `wsl -l` will not show that the distribution is installed until this step is complete).
248+
Once the package has finished installing, you can start running the new distribution by double-clicking the appx file. (The command `wsl -l` will not show that the distribution is installed until this step is complete).
252249

253250
If you are using Windows server, or run into problems running the command above you can find the alternate install instructions on the [Windows Server](install-on-server.md) documentation page to install the `.Appx` file by changing it to a zip file.
254251

0 commit comments

Comments
 (0)