# 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](../reference/firewall_requirements.md). (howto::install-up4w)= ## Install UP4W % :TODO: remove this warning once the app is made generally available (after the beta period). ```{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](https://apps.microsoft.com/detail/9PD1WZNBDXKZ): ![Install Ubuntu Pro for WSL from the Store](./assets/store.png) (howto::config-up4w)= ## 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. ````{tabs} ```{group-tab} Windows registry ## 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](https://learn.microsoft.com/en-us/troubleshoot/windows-server/performance/windows-registry-advanced-users) about alternative methods for modifying the registry data. To open the registry type `Win+R` and enter `regedit`: ![Windows where regedit command is run.](./assets/regedit.png) ## Add Pro token in the registry Navigate to `HKEY_CURRENT_USER\Software\Canonical\UbuntuPro`: ![Windows registry showing UbuntuPro in tree.](./assets/registry-default.png) Input your Ubuntu Pro token in `UbuntuProToken > Modify > Write the Ubuntu Pro token`: ![Windows registry showing UbuntuPro in tree.](./assets/registry-token.png) 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](./assets/status-complete-registry.png) ``` ```{group-tab} Graphical Windows application ## Enter your Pro token Enter your Ubuntu Pro token in the space provided: ![Graphical interface of Ubuntu Pro for WSL with option to paste Pro token.](../assets/token-input-placeholder.png) Continue to the confirmation screen. ## Confirm subscription is active You should now see that your Pro subscription is active: ![Confirmation in graphical interface that subscription is active.](../assets/status-complete.png) 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](./verify-subscribe-attach.md).