No description
Find a file
Shane Crowley d6a2febd77
docs: Update root md files after docs merge (#515)
Updates README and CONTRIBUTING files to account for:

* latest docs now being found in UP4W repo
* new distro format becoming available (we were linking to an archived
distro builder repo)

Public docs are no longer consuming the CONTRIBUTING.md file, so the
changes only affect the files in this repo.

Related PR in Ubuntu Pro for WSL repo:
https://github.com/canonical/ubuntu-pro-for-wsl/pull/1138

UDENG-6052
2025-02-26 13:39:13 +00:00
.github Add Ubuntu-24.04 2025-02-21 15:08:17 -06:00
DistroLauncher Skip cloud-init if disabled 2024-12-17 10:43:57 -03:00
DistroLauncher-Appx Remove the props file in the main tree 2024-01-30 09:56:14 -03:00
docs add redirect from autoinstall doc to cloud-init doc 2024-10-03 09:45:51 +01:00
e2e Turn off the WSL1 test case for now. 2024-12-18 11:06:02 -03:00
meta Refreshes releases and assets 2024-09-21 02:03:43 +00:00
wsl-builder Fix the rootfs URL computation 2024-12-17 09:39:50 -03:00
.gitignore Let the build system define preprocessor macros 2022-07-29 13:09:20 -03:00
.gitmodules Removes the UDI submodule 2024-01-30 10:59:31 -03:00
build-remote Build: fix latest LTS detection 2024-04-17 14:22:24 +02:00
build.bat Add Visual Studio 2019 Community support (#74) 2021-09-16 15:06:30 +02:00
CONTRIBUTING.md general fixups 2025-02-25 17:34:43 +00:00
DistroLauncher.sln Hardcode and parameterize project settings 2021-09-16 15:06:30 +02:00
go.mod Update Go to 1.21 2023-11-23 16:53:54 +01:00
go.work Update Go to 1.21 2023-11-23 16:53:54 +01:00
go.work.sum Update Go to 1.21 2023-11-23 16:53:54 +01:00
LICENSE Initial commit 2017-05-16 10:28:25 -07:00
README.md general fixups 2025-02-25 17:34:43 +00:00
SECURITY.md add security policy file 2024-12-10 12:07:43 +00:00

Ubuntu on WSL distribution

Install a complete Ubuntu terminal environment in minutes with Windows Subsystem for Linux (WSL). Develop cross-platform applications, improve your data science or web development workflows and manage IT infrastructure without leaving Windows.

Read about the distributions of Ubuntu available for WSL.

Key features:

  • Efficient command line utilities including bash, ssh, git, apt, npm, pip and many more
  • Manage Docker containers with improved performance and startup times
  • Leverage GPU acceleration for AI/ML workloads with NVIDIA CUDA
  • A consistent development to deployment workflow when using Ubuntu in the cloud
  • 5 years of security patching with Ubuntu Long Term Support (LTS) releases

For more information about Ubuntu WSL and how Canonical supports developers please visit:

https://ubuntu.com/wsl

Note

The documentation for Ubuntu on WSL can be found at https://documentation.ubuntu.com/wsl/. The source for that documentation can be found in the Ubuntu Pro for WSL repo. If you are interested in contributing to the documentation, please submit your Issues and Pull Requests there.

This repository

This repository contains code relevant to the Ubuntu distribution on WSL. It builds on top of Microsoft's distro launcher reference implementation.

Tip

There is a newer method for creating the Ubuntu on WSL distro. We will be updating the Ubuntu on WSL documentation as this method is adopted. Refer to this blog about installing Ubuntu with the new distribution format.

Issues & Contact

You are welcome to create a new issue on this repository if you find bugs you believe may be particular to Ubuntu running on WSL.

Feel free to otherwise head over to Microsoft's WSL page on GitHub if your report is not specific to Ubuntu but rather more general to WSL.

We also have a page on Launchpad; we check it less often but you may find part of the community there. Ubuntu's Discourse page has news and interesting discussions about Ubuntu on WSL.