mhackermsft/wslcontainerdesktop v2.4.0

WSL Container Desktop 2.4.0

on GitHub

Release highlights

• Inline Compose configs.content imports, including multiline JSON, are persisted locally and mounted read-only. Reviewed content changes replace affected containers; Restart retains the applied content.
• Compose bind-mount inference and localized resource discovery are fixed, with safer inventory/create-race handling.
• Docker Hub username normalization and registry logout/removal recovery are improved.

Data handling: Resolved inline config text, including interpolated credentials, remains in local plaintext project JSON and staged files. It is not encrypted secret storage.

Validation: x64 Debug build completed with zero warnings/errors; 5,937 automated tests passed across both target frameworks; all 25 installer checks passed under both Windows PowerShell 5.1 and PowerShell 7. The release workflow also completed successfully. Opt-in engine tests were excluded. Packaged English/Simplified Chinese UI smoke and actual pgAdmin startup/server-import smoke remain unverified; these gaps were explicitly accepted for this release. Local installation verification does not establish application startup or UI rendering correctness.

WSL Container Desktop 2.4.0

What's new in this version — full changelog.

Install (recommended: download only the helper)

1. Download Install.ps1 below into a writable folder.
2. Open PowerShell in that folder and run:

powershell -ExecutionPolicy Bypass -File .\Install.ps1

1. The helper downloads and verifies this release's missing .cer and .msix.
   Approve the administrator prompt to trust the displayed publisher certificate.
   The app then installs in your original Windows session.
2. Launch WSL Container Desktop from the Start menu.

Internet access is needed only for missing assets. For offline installation, put this release's
.cer and .msix beside the script first. Saved scripts stay pinned to their original release;
download a fresh helper from the latest stable release to install a newer version.

-ExecutionPolicy Bypass applies only to this PowerShell process; it does not change your
machine's policy. It avoids the default RemoteSigned block on this unsigned downloaded script.
Alternatively, unblock only the helper, then right-click Install.ps1 > Run with PowerShell:

Unblock-File -Path .\Install.ps1

Manual installation (without a script)

1. Download the .msix and .cer assets below into the same folder.
2. Open that folder, then open an elevated PowerShell (Run as administrator).
3. cd into the download folder and run (adjust the file names to this release):

Import-Certificate -FilePath .\WSLContainerDesktop-Signing.cer -CertStoreLocation Cert:\LocalMachine\TrustedPeople
Add-AppxPackage -Path .\WSLContainerDesktop_2.4.0_x64.msix -ForceUpdateFromAnyVersion

1. Launch WSL Container Desktop from the Start menu.

The first command trusts the app's self-signed publisher certificate (CN=Michael Hacker)
so Windows accepts the sideloaded package; the second installs (or updates) the app.

Updating

Once installed, the app checks for new releases when it starts and offers Update now,
which downloads, installs and reopens it. You can also update manually by repeating the
steps above with a newer release.

Self-signed, self-contained package (bundles the .NET and Windows App SDK runtimes, so nothing else is required). Not a Microsoft product and carries no warranty - see the repository README.