Skip to content

docs: add WSL install instructions to README #18247

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
reubeno merged 3 commits into from
Aug 1, 2026
+110 −1
Merged

docs: add WSL install instructions to README #18247

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
55bb320
docs: add WSL install instructions to README
mfrw Jul 29, 2026
b7f2138
docs: use aka.ms link and do a few cosmetic changes
mfrw Jul 30, 2026
95f10e9
docs: add WSL package signature and checksum verification
mfrw Jul 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 29 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

**An open-source Linux distribution built and optimized for [Azure](https://azure.microsoft.com/), with sources derived from [Fedora Linux](https://fedoraproject.org/).** Azure Linux provides a secured, reliable operating system for virtual machines, containers, and bare-metal platforms.

Azure Linux is built on a robust open-source foundation from the Fedora ecosystem and enhanced with Azure-specific innovations. This provides the familiarity of the RPM package ecosystem, while adding Azure-native security, compliance, and operational capabilities.
Azure Linux is built on a robust open-source foundation from the Fedora ecosystem and enhanced with Azure-specific innovations. This provides the familiarity of the RPM package ecosystem, while adding Azure-native security, compliance, and operational capabilities.

Key features of Azure Linux include: hardened security posture, an Azure-optimized kernel, supply chain security, native Azure integration, and a predictable lifecycle.

Expand Down Expand Up @@ -55,6 +55,34 @@ _Note: Support for the ISO is community based. Before filing a new bug or featur

</details>

<details open>
<summary><b>🐧 WSL</b></summary>
Comment thread
mfrw marked this conversation as resolved.
Outdated

To try Azure Linux on the Windows Subsystem for Linux, please download the `.wsl` distribution package for your architecture:

- [x86_64](https://osrelease.download.prss.microsoft.com/pr/download/AzureLinux-4.0-x86_64.wsl)
Comment thread
mfrw marked this conversation as resolved.
Outdated
Comment thread
mfrw marked this conversation as resolved.
Outdated
- [ARM64](https://osrelease.download.prss.microsoft.com/pr/download/AzureLinux-4.0-aarch64.wsl)

Install the distribution using `wsl`:

```powershell
wsl --install --from-file "C:\Path\To\AzureLinux-4.0-ARCH.wsl"
Comment thread
mfrw marked this conversation as resolved.
```

To list all the installed distributions:

```powershell
wsl --list
```

To use the distro:

```powershell
wsl -d AzureLinux-4
```

</details>

## What's in this branch?

Azure Linux 4 is an RPM-based distribution optimized for Azure and modern cloud workloads. It is defined by a set of TOML configuration files and targeted *overlays* applied to [Fedora Linux](https://fedoraproject.org/), its upstream base.
Expand Down
Loading