Welcome to Ubuntu Pro for WSL

This is the code repository for Ubuntu Pro for WSL, the bridge from Ubuntu WSL instances to Ubuntu Pro.

It contains the set of applications to manage Ubuntu WSL instances that allows you to:

• Grant ‘pro-enabled’ status to any Ubuntu instance on the device
• Orchestrate instances for Landscape
• Manages instance states (spin up/down to apply policies/patches).

Documentation

You can read all about Ubuntu Pro for WSL on Read the docs.

System Components

The system consists of the following components:

• A Windows AppxPackage consisting of an agent with its user interface. See Windows Agent.
• An Ubuntu WSL Pro Service and its associated API. This interface controls the Pro and Landscape status between the agent running on Windows and the WSL instance. See WSL Pro Service.
• An interface between the agent and Ubuntu Pro to handle the transactions with the contract server.
• An interface between the agent and Landscape to manage the WSL instances from Landscape.
• A WSL management API. This interface controls the lifecycle of the WSL instances, like provisioning, updates, and starting or stopping the WSL instances.
• cloud-init is used to customize the images on first boot or to reconfigure an image.

Get involved

This is an open source project and we warmly welcome community contributions, suggestions, and constructive feedback. If you're interested in contributing, please take a look at our Contribution guidelines first.

• to report an issue, please file a bug report against our repository, using a bug template.
• for suggestions and constructive feedback, report a feature request bug report, using the proposed template.

Get in touch

We're friendly! We have a community forum at https://discourse.ubuntu.com where we discuss feature plans, development news, issues, updates and troubleshooting.

For news and updates, follow the Ubuntu twitter account and on Facebook.

Troubleshooting

//TODO: fill troubleshooting section