docs: add WSL install instructions to README - #18247
Open
mfrw wants to merge 3 commits into
Open
Conversation
Azure Linux 4 now publishes a .wsl distribution package alongside the
Azure VM, container, and ISO artifacts, but the README had no pointer to
it. Add a "Using Azure Linux" section covering the per-architecture
download links and the wsl commands to install, list, and enter the
distro.
The distro name in `wsl -d AzureLinux-4` matches what wsl-setup derives
at install time from /etc/os-release ("${NAME// /}-${VERSION_ID%.*}"),
which resolves to AzureLinux-4 for Azure Linux 4.0.
Signed-off-by: Muhammad Falak R Wani <falakreyaz@gmail.com>
reubeno
reviewed
Jul 29, 2026
tobiasb-ms
requested changes
Jul 29, 2026
Signed-off-by: Muhammad Falak R Wani <falakreyaz@gmail.com>
Add the equivalent document for WSL and link it from the WSL section of the README. The new doc mirrors the ISO one: a per-architecture bash block that verifies the checksum file against the Azure Linux RPM signing key, then checks the package against that checksum. A PowerShell section covers the common case of downloading on Windows with no WSL distro available yet; it is driven by a single $Arch variable so one block serves both architectures. Downloads use the versioned aka.ms shortlinks rather than the earlier unversioned wslazlinux-<arch> links, matching the naming already used for the ISO. The versioned form lets 4.0 and future releases coexist instead of repointing a single link. The README download links are switched over for the same reason. wget saves a redirected download under the shortlink basename, so CHECKSUM_FILE and SIGNATURE_FILE use the shortlink names. The package download needs an explicit -O because the checksum file records the package as AzureLinux-4.0-<arch>.wsl, whose casing differs from the lowercase shortlink; without it sha256sum --check fails to find the file. Verified end to end through the live aka.ms links for both architectures: signatures report a good signature from the Mariner RPM Release Signing key and both packages pass sha256sum --check. The PowerShell block was run on PowerShell 7.6.4 for both values of $Arch. Corrupting a package was confirmed to fail the check in both the bash and PowerShell paths. Signed-off-by: Muhammad Falak R Wani <falakreyaz@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Azure Linux 4 now publishes a .wsl distribution package alongside the
Azure VM, container, and ISO artifacts, but the README had no pointer to
it. Add a "Using Azure Linux" section covering the per-architecture
download links and the wsl commands to install, list, and enter the
distro.
The distro name in
wsl -d AzureLinux-4matches what wsl-setup derivesat install time from /etc/os-release ("${NAME// /}-${VERSION_ID%.*}"),
which resolves to AzureLinux-4 for Azure Linux 4.0.
Signed-off-by: Muhammad Falak R Wani falakreyaz@gmail.com