Install UP4W and add a Pro token

To install and configure UP4W you will need:

  • A Windows 10 or 11 machine

  • An Ubuntu Pro token

You should also verify that the firewall rules are correctly set up.

Install UP4W

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 UP4W on this page of the Microsoft Store:

Install Ubuntu Pro for WSL from the Store

Choose a configuration method

After installation has finished you can start configuring UP4W 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.

Access the registry

First, ensure that UP4W has run at least once after installation. This ensures that the key and values necessary for configuration will be set up in the registry.

Advanced users of the registry can find relevant information in the Microsoft documentation about alternative methods for modifying the registry data.

To open the registry type Win+R and enter regedit:

Windows where regedit command is run.

Add Pro token in the registry

Navigate to HKEY_CURRENT_USER\Software\Canonical\UbuntuPro:

Windows registry showing UbuntuPro in tree.

Input your Ubuntu Pro token in UbuntuProToken > Modify > Write the Ubuntu Pro token:

Windows registry showing UbuntuPro in tree.

After configuration using the Windows Registry the status in the UP4W Windows 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:

alt text

For additional verification steps refer to our guide.