https://github.com/syslogic/wsl2-rocky-linux

WSL2 Distro Builder
https://github.com/syslogic/wsl2-rocky-linux

powershell rhel9 rocky-linux wsl2

Last synced: 6 months ago
JSON representation

WSL2 Distro Builder

• Host: GitHub
• URL: https://github.com/syslogic/wsl2-rocky-linux
• Owner: syslogic
• Created: 2025-07-07T20:00:41.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2025-07-07T23:36:35.000Z (8 months ago)
• Last Synced: 2025-07-08T00:47:38.215Z (8 months ago)
• Topics: powershell, rhel9, rocky-linux, wsl2
• Language: Dockerfile
• Homepage:
• Size: 41 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
## WSL2 Distro Builder

There's one [`Dockerfile`](https://github.com/syslogic/wsl2-rocky-linux/blob/master/Dockerfile) and the build-script is being called: [`.\refresh.ps1`](https://github.com/syslogic/wsl2-rocky-linux/blob/master/refresh.ps1)


which builds a Rocky Linux image and converts it into a [WSL](https://github.com/microsoft/WSL) Linux distribution.

### Prerequisites

- [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/install) 

- [GZip for Windows](https://gnuwin32.sourceforge.net/packages/gzip.htm) on `$PATH`

- [Docker Desktop](https://www.docker.com/products/docker-desktop/)

- [PowerShell Core](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.5#install-powershell-using-winget-recommended)

### Installation

a) The script ultimately runs `wsl --import`, which means the distribution is being installed.


b) When double-clicking `Rocky.x86_64-9.6.wsl`, it will install it with distribution-name `runner`.

![Screenshot 01](https://raw.githubusercontent.com/syslogic/wsl2-rocky-linux/master/screenshots/screenshot_01.png)

### Uninstall

The command would be:

 - `wsl --unregister RockyLinux_9_6`

 - `wsl --unregister runner`

 ---

The official base-images could also be obtained directly from [`rockylinux.org`](https://rockylinux.org).

- [`Rocky-9-WSL-Base-9.6-20250531.0.x86_64.wsl`](https://dl.rockylinux.org/pub/rocky/9.6/images/x86_64/Rocky-9-WSL-Base-9.6-20250531.0.x86_64.wsl)

- [`Rocky-10-WSL-Base-10.0-20250611.0.x86_64.wsl`](https://dl.rockylinux.org/pub/rocky/10.0/images/x86_64/Rocky-10-WSL-Base-10.0-20250611.0.x86_64.wsl)