This case tests provisioning a tar-based WSL image as WSL 1.
It requires a working Microsoft Windows 11 or higher installation with WSL version 2.4.10 or later. Installing Windows and enabling WSL 2 is outside of the scope of this test case.
Since the release of Ubuntu LTS 24.04.2 Noble Numbat, tar-based images are found at https://cdimages.ubuntu.com/ubuntu-wsl/
and their file extension is ".wsl" instead of ".tar.gz".
For example for latest noble image: https://cdimages.ubuntu.com/ubuntu-wsl/daily-live/noble/pending/noble-wsl-amd64.wsl
Make sure to download the image matching the correct release under test from the download link associated to this test case.
WSL 1 doesn't support systemd, thus we skip checking if its running, if there are failed units. We also assume
cloud-init cannot run under such environment.
After downloading the image, open PowerShell and follow the steps below:
- Install a new instance as WSL 1
- Navigate to the folder where you downloaded the image into and enter the following
command, adjusting to the correct release name under test
> wsl --install --from-file .\noble-wsl-amd64.wsl --location .\Noble --name Noble --version 1
- Verify that the new instance has been registered as WSL 1 by running the following command:
> wsl.exe --list --all --verbose
NAME STATE VERSION
*Ubuntu Running 2
Noble Stopped 1
Ubuntu-20.04 Stopped 2
TestUbuntuWSL Stopped 2
- Check the **name** used in previous command appears in the list.
- Launch the new instance. The provisioning (OOBE) command will run and eventually will prompt for
the new user creation. The input line should be prefilled with a user name derived from the
current Windows user name.
- In the example below the Windows user name is ubuntu
> wsl -d Noble
Provisioning the new WSL instance Ubuntu-24.04
This might take a while...
Create a default Unix user account: ubuntu
- Hit enter and proceed with the default user creation. Once done you should be running bash inside
the distro instance
Provisioning the new WSL instance Ubuntu-24.04
This might take a while...
Create a default Unix user account: ubuntu
New password:
Retype new password:
passwd: password updated successfully
To run a command as administrator (user "root"), use "sudo ".
See "man sudo_root" for details.
Welcome to Ubuntu 24.04.2 LTS (GNU/Linux 5.15.167.4-microsoft-standard-WSL2 x86_64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/pro
System information as of Tue Feb 11 11:43:37 -03 2025
System load: 0.17 Processes: 31
Usage of /: 0.1% of 1006.85GB Users logged in: 0
Memory usage: 6% IPv4 address for eth0: 172.22.8.90
Swap usage: 15%
This message is shown once a day. To disable it please create the
/home/ubuntu/.hushlogin file.
ubuntu@mib01:/mnt/c/Users/ubuntu$
- Verify that you're running the right distribution (point) release. For example run:
$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 24.04.2 LTS
Release: 24.04
Codename: noble
- The default user
- You should be logged in with the user that you just created
$ whoami
ubuntu
- Run a command as root with sudo, for instance
$ sudo apt update
- Verify that the command ends successfully
- Apply any update
$ sudo apt full-upgrade
- Verify that the command ends successfully and that any packge that must be upgraded has been upgraded
- Install a package
$ sudo apt install hello
- Verify that the package has been successfully installed and the application can run
$ hello
Hello, world!
- Check that Windows interoperability is still working
- Launch a Windows application
> notepad.exe # It should open.
- List the contents of the C:\Windows
> ls -l /mnt/c/Windows
dr-xr-xr-x 1 root root 512 Feb 11 08:58 AppReadiness
dr-xr-xr-x 1 root root 512 Apr 1 2024 Boot
dr-xr-xr-x 1 root root 512 Apr 1 2024 Branding
dr-xr-xr-x 1 root root 512 Oct 7 14:37 BrowserCore
dr-xr-xr-x 1 root root 512 Jun 4 2024 CSCmnt
[...]
- Exit WSL
logout
- Check that your back to the PowerShell prompt
- Unregister the distro instance
> wsl.exe --unregister Noble
- The isntance no longer listed
> wsl --list
Windows Subsystem for Linux Distributions:
Ubuntu (Default)
Ubuntu-20.04
TestUbuntuWSL
If all actions produce the expected results listed, please submit a 'passed' result.
If an action fails, or produces an unexpected result, please submit a 'failed' result and file a bug. Please be sure to include the bug number when you submit your result.
