Create Fedora Windows Subsystem for Linux Images
This document represents a proposed Change. As part of the Changes process, proposals are publicly announced in order to receive community feedback. This proposal will only be implemented if approved by the Fedora Engineering Steering Committee.
Summary
Recent versions of Windows support running Linux guests via Windows Subsystem for Linux (WSL). These can be distributed via the Windows Store, or as tarballs, or Appx files for users to download and install. The purpose of this change is to start producing Fedora images for users of WSL.
Owner
- Name: Jeremy Cline
- Name: Cloud SIG
- Email: jeremy@jcline.org
Current status
- Targeted release: Fedora Linux 42
- Last updated: 2024-08-30
- [<will be assigned by the Wrangler> devel thread]
- FESCo issue: <will be assigned by the Wrangler>
- Tracker bug: <will be assigned by the Wrangler>
- Release notes tracker: <will be assigned by the Wrangler>
Detailed Description
Recent versions of Windows support running Linux distributions using Windows Subsystem for Linux (WSL). In the latest version, WSL 2, a single virtual machine is managed by the Windows host and guest Linux distributions run as containers within it. For basic WSL support, Fedora needs to distribute a root filesystem tarball. The Fedora base container can already be used with WSL, but it is not ideal as it intentionally excludes documentation and non-essential tools. There also isn't official documentation on how to use it with WSL.
The goal of this change is to complete the following:
- Add a WSL variant to https://src.fedoraproject.org/rpms/fedora-release/
- Create a Kiwi definition to produce a WSL root filesystem tarball.
- Write documentation on how to use the tarball with WSL.
In future changes, we can build on this change to enable a smoother user experience. It is possible to distribute WSL distributions as Windows Appx packages. These are composed of the root filesystem tarball along with a Windows executable to handle setting up the distribution automatically, enabling users to install the Fedora WSL environment with a few clicks.
Feedback
Benefit to Fedora
A dedicated image with documentation allows people to easily try out a Fedora environment from their Windows installations. When it comes time to install a Linux distribution on their computer, they can be more confident when choosing Fedora.
Scope
- Proposal owners:
- Other developers:
- Release engineering: #Releng issue number
- Policies and guidelines: N/A (not needed for this Change)
- Trademark approval: N/A (not needed for this Change)
- Alignment with Community Initiatives:
Upgrade/compatibility impact
How To Test
- Have access to a Windows 10 or 11 installation (VMs should work)
- On the Windows host, download the WSL tarball from <somewhere>
- Open up a Windows terminal and install WSL itself with "wsl --install"
- Import the WSL tarball with "wsl --import Fedora C:\Users\<username>\AppData\Local\WSL\Fedora .\Path\To\Fedora.x86_64.tar.xz"
- Enter the environment with "wsl -d Fedora"
- Install some applications, start some services, see if things fall over.
User Experience
Dependencies
Contingency Plan
- Contingency mechanism: (What to do? Who will do it?) Don't ship the tarball
- Contingency deadline: N/A (not a System Wide Change)
- Blocks release? No
Documentation
Add a section somewhere in https://docs.fedoraproject.org/ (perhaps quick docs) with a short guide on installing the tarball.