Skip to content

Moves all Ubuntu distros to the tar-based format#14463

Merged
OneBlue merged 2 commits intomicrosoft:masterfrom
CarlosNihelton:ubuntu-all-tar
Mar 17, 2026
Merged

Moves all Ubuntu distros to the tar-based format#14463
OneBlue merged 2 commits intomicrosoft:masterfrom
CarlosNihelton:ubuntu-all-tar

Conversation

@CarlosNihelton
Copy link
Contributor

@CarlosNihelton CarlosNihelton commented Mar 17, 2026

Summary of the Pull Request

This PR aims to move all Ubuntu LTSes to the new tar-based format, removing support for the versioned appx based distros.
The existing instances will continue working as expected, but new installations shouldn't fetch appx's from Microsoft Store. Instead, new installations are going to leverage the new tar based format, bringing consistency to all Ubuntu LTSes on WSL.
The default unversioned Ubuntu appx is preserved as is, for backwards compatibility, ensuring that the "Default" field works on both modern and legacy WSL setups.

PR Checklist

  • Closes: Link to issue #xxx
  • Communication: I've discussed this with core contributors already. If work hasn't been agreed, this work might be rejected
  • Tests: Added/updated if needed and all pass
  • Localization: All end user facing strings can be localized
  • Dev docs: Added/updated if needed
  • Documentation updated: If checked, please file a pull request on our docs repo and link it here: #xxx

Detailed Description of the Pull Request / Additional comments

Validation Steps Performed

Used the resulting DistributionInfo.json as a replacement manifest by writing its path in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss DIstributionListURL value, then installed Ubuntu-22.04 and Ubuntu-20.04.

We backported the build pipeline so all current LTSes come out in the new tar-based format
All WSL users can run tar-based distros by now, right?
There is no benefit in maintaining both formats.
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the WSL distribution manifest to prefer tar-based (“modern”) Ubuntu LTS installations over legacy Store/Appx-based installs, aiming for consistent installation behavior across Ubuntu LTS versions.

Changes:

  • Added Ubuntu-22.04 and Ubuntu-20.04 entries under ModernDistributions with tar-based .wsl URLs and SHA-256 hashes.
  • Removed legacy Distributions (Store/Appx) entries for Ubuntu-20.04, Ubuntu-22.04, and Ubuntu-24.04 from the manifest.

Comment on lines 268 to 272
"Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/KaliLinux_1.13.1.0.AppxBundle",
"Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/KaliLinux_1.13.1.0.AppxBundle",
"PackageFamilyName": "KaliLinux.54290C8133FEE_ey8k8hqnwqnmg"
},
{
"Name": "Ubuntu-20.04",
"FriendlyName": "Ubuntu 20.04 LTS",
"StoreAppId": "9MTTCL66CPXJ",
"Amd64": true,
"Arm64": true,
"Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2004-230608_x64.appx",
"Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2004-230608_ARM64.appx",
"PackageFamilyName": "CanonicalGroupLimited.Ubuntu20.04LTS_79rhkp1fndgsc"
},
{
"Name": "Ubuntu-22.04",
"FriendlyName": "Ubuntu 22.04 LTS",
"StoreAppId": "9PN20MSR04DW",
"Amd64": true,
"Arm64": true,
"Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2204LTS-230518_x64.appx",
"Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2204LTS-230518_ARM64.appx",
"PackageFamilyName": "CanonicalGroupLimited.Ubuntu22.04LTS_79rhkp1fndgsc"
},
{
"Name": "Ubuntu-24.04",
"FriendlyName": "Ubuntu 24.04 LTS",
"StoreAppId": "9NZ3KLHXDJP5",
"Amd64": true,
"Arm64": true,
"Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2404-240425.AppxBundle",
"Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2404-240425.AppxBundle",
"PackageFamilyName": "CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc"
},
{
@OneBlue
Copy link
Collaborator

OneBlue commented Mar 17, 2026

@CarlosNihelton: One side effect of doing this is that old Windows builds that don't have tar based distribution support will fail if the user runs:

wsl --install

Since 'ubuntu' is the default.
This will happen on builds that don't have the WSL package and still use the inbox version.

These builds are technically out of support, but I would still like to avoid hard-breaking them. I can think of two solutions:

  1. Keep one 'ubuntu' appx image for backwards compatibility

  2. Change the default to another distribution (note that 'Default' applies to both tar based and appx distros)

@craigloewen-msft FYI

@CarlosNihelton
Copy link
Contributor Author

CarlosNihelton commented Mar 17, 2026

@CarlosNihelton: One side effect of doing this is that old Windows builds that don't have tar based distribution support will fail if the user runs:

wsl --install

Since 'ubuntu' is the default. This will happen on builds that don't have the WSL package and still use the inbox version.

These builds are technically out of support, but I would still like to avoid hard-breaking them. I can think of two solutions:

1. Keep one 'ubuntu' appx image for backwards compatibility

2. Change the default to another distribution (note that 'Default' applies to both tar based and appx distros)

Hi @OneBlue ! Thanks for the quick notice!

If I got you correctly, we should be fine as the unversioned Ubuntu appx is preserved as is (no breaking changes for wsl --install on inbox WSL), right? https://github.com/microsoft/WSL/pull/14463/changes#diff-37fca1278e3439911b7860efe087b392e165e11b29fbeeb21035a9402cf134c4L217

Let me rephrase my PR description, as I'm only touching the versioned apps.

Yet, it's worth raising the question: until when do we believe the appx will still be necessary?

@CarlosNihelton
Copy link
Contributor Author

Yet, it's worth raising the question: until when do we believe the appx will still be necessary?

We can discuss this topic later if there is no clear answer as of now.

@OneBlue
Copy link
Collaborator

OneBlue commented Mar 17, 2026

Let me rephrase my PR description, as I'm only touching the versioned apps.

Ah indeed I misread the diff and assumed that all the appx ubuntu distros were being moved. If we're keeping the default unversionned appx, then I'm not worried about this.

Yet, it's worth raising the question: until when do we believe the appx will still be necessary?

That's a great question ! I don't have a clear answer to it right now. If this ever become a problem to maintain on the Ubuntu side, we should probably discuss this with @craigloewen-msft

@OneBlue
Copy link
Collaborator

OneBlue commented Mar 17, 2026

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@OneBlue OneBlue merged commit df38f2c into microsoft:master Mar 17, 2026
11 of 12 checks passed
@CarlosNihelton CarlosNihelton deleted the ubuntu-all-tar branch March 19, 2026 15:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants