How-to guides

The guides in this section will help you to complete specific tasks with Ubuntu on WSL.

They include guides on the Ubuntu distribution and the Ubuntu Pro for WSL application.

Installation and setup

Get set up using Ubuntu on a Windows machine with WSL.

• Installation and setup
  • Install Ubuntu on WSL
  • Upgrade Ubuntu
  • Manage and configure instances of Ubuntu on WSL
  • Automatic setup of Ubuntu on WSL with cloud-init
  • Customise an Ubuntu distro for WSL
  • Install Ubuntu Pro for WSL and add a Pro token
  • Verify Pro subscription and attachment
  • Uninstalling Ubuntu Pro for WSL, Ubuntu WSL apps and WSL

Remote deployment

Use the Pro for WSL application to remotely manage Ubuntu on WSL.

• Remote deployment
  • Configure the Landscape client with Ubuntu Pro for WSL
  • Create WSL instances on multiple Windows machines with the Landscape API
  • Enforce the Ubuntu Pro for WSL background agent startup remotely using the Windows Registry
  • Start the Ubuntu Pro for WSL background agent remotely

GPU and graphics

Leverage GPU and graphical support with Ubuntu on WSL.

• GPU and graphics
  • Enabling GPU acceleration with CUDA
  • Use WSL for data science and visualise results graphically

Contributing

Contribute to the development of Ubuntu on WSL.

• Contributing
  • General contribution guidelines
  • Install Ubuntu Pro for WSL for development
  • Restart Ubuntu Pro for WSL for development
  • Access Ubuntu Pro for WSL logs for development
  • Enable Ubuntu Pro for WSL features for development
  • Reset Ubuntu Pro for WSL

Testing

Automate the testing of applications for Ubuntu on WSL with GitHub workflows.

• Run a WSL GitHub workflow on Azure