Install Ubuntu Pro for WSL and add a Pro token¶
Ubuntu Pro
This page refers to features that require an Ubuntu Pro subscription and access to the Ubuntu Pro for WSL application. The application is currently in beta and not yet generally available.
To install and configure Ubuntu Pro for WSL you will need:
Windows 11 (recommended) or Windows 10 with minimum version 21H2 on a physical machine
An Ubuntu Pro token
You should also verify that the firewall rules are correctly set up.
Install Ubuntu Pro for WSL¶
Warning
The install link below will work only if you’re logged in to the Microsoft Store with an account for which access to the app has been enabled.
You can install Pro for WSL on this page of the Microsoft Store:
Choose a configuration method¶
After installation has finished you can start configuring Pro for WSL in two ways:
Windows registry: easier to automate and deploy at scale
Graphical Windows application: convenient option for individual users
Click the appropriate tab to read more.
Set up the key and values
First, ensure that Ubuntu Pro for WSL has run at least once after installation. This guarantees that the key and values necessary for configuration are set up in the registry.
Methods of modifying registry data
This guide uses the registry editor for setting the Pro token.
Advanced users of the registry can find relevant information in the Microsoft documentation for alternative methods to modify the registry data.
Add Pro token using the registry editor
To open the registry editor on a Windows machine, type
Win+R then enter regedit:
Navigate to the HKEY_CURRENT_USER\Software\Canonical\UbuntuPro key.
Locate the UbuntuProToken value and enter your Pro token in the Value data field.
After configuration using the Windows Registry the status in the Pro for WSL application will show that the Pro subscription is active and managed by the user’s organisation. Unlike installation through the graphical Windows application, there is no option to detach the Pro subscription in the application interface when the registry is used:
Enter your Pro token
Enter your Ubuntu Pro token in the space provided:
Continue to the confirmation screen.
Confirm subscription is active
You should now see that your Pro subscription is active:
Opening the application again at any point will show this screen, confirm the subscription is active and enable detaching of the subscription.
For additional verification steps refer to our guide.