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
  • Back up and restore Ubuntu WSL instances
  • Automatic setup of Ubuntu on WSL with cloud-init
  • Install UP4W and add a Pro token
  • Verify Pro subscription and attachment
  • Uninstalling UP4W, Ubuntu WSL apps and WSL

Remote deployment

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

• Remote deployment
  • Configure the Landscape client with UP4W
  • Create WSL instances on multiple Windows machines with the Landscape API
  • Enforce the UP4W background agent startup remotely using the Windows Registry
  • Start the UP4W 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 UP4W for development
  • Restart UP4W for development
  • Access UP4W logs for development
  • Enable features for development
  • Reset UP4W

Testing

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

• Run a WSL GitHub workflow on Azure