wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2025 winget.ragerworks.com

Loading...
Install easyWSL using Winget - wingetCollections
  1. Go back
  2. Packages
  3. easyWSL
easyWSL logo

easyWSL Red Code Labs

custom-wsl-distro docker docker-container powershell windows winui wsl wsl-distro wsl2
Use this command to install easyWSL:
winget install --id=RedCodeLabs.easyWSL -e

Create WSL distros based on Docker Images.

easyWSL is a powerful tool designed to simplify the creation of Windows Subsystem for Linux (WSL) distributions based on Docker images. It allows users to leverage Docker Hub images and convert them into WSL distros, enabling seamless integration of Linux environments on Windows 10 or 11 systems.

Key Features:

  • Create WSL distributions directly from Docker Hub images.
  • User-friendly graphical interface built with WinUI framework.
  • Manage WSL distros with features like unregistering, accessing .vhdx files, and viewing filesystems.
  • Advanced settings for adjusting memory, CPU cores, swap size, and more.
  • Snapshot functionality for backups and restore points.
  • Experimental support for creating users during installation and integrating development environments like Python, Node.js, and C/C++.

Audience & Benefit: Ideal for developers, IT professionals, and Windows users who need to work with Linux environments. easyWSL streamlines the process of setting up and managing WSL distributions, offering a customizable and efficient solution that integrates seamlessly with Docker. It empowers users to optimize their workflow by tailoring resources and experimenting with advanced configurations.

README

easyWSL

Create WSL distros based on Docker Images.

> Made with ❤ by @redcode-labs team.

What does this project do?

easyWSL makes it way easier to use the wonders of WSL functionality on Windows 10 and 11 systems. Thanks to our efforts, easyWSL grants you an access to use most (almost all) system images from Docker Hub as WSL distros. Our C# sorcery allows us to use Docker Hub API in order to get .tar or .tar.gz images from there. After getting an image, single or multi-layered, we turn it into single image (multi-layered Docker image case) which we easily import as WSL distro.

https://user-images.githubusercontent.com/40501814/161391038-10bf9360-429d-4a47-887f-63b35fae90cd.mp4

Features

In our latest release, we've added even more features than ever before. All of them wrapped around GUI app using a beauty of WinUI framework.

We've managed to add management features to WSL. With a single click, you can unregister, open .vhdx location as well as see the filesystem of the given distro.

https://user-images.githubusercontent.com/40501814/161391082-101aeaa4-48e1-4cc6-bac3-9bc251efe469.mp4

While this sounds so good so far, we've also made a separate 'Settings' page, to manage your WSL in general. There you can easily adjust things like memory, the number of cores or the swap size assigned with WSL VM. You can also point to different swap file, custom Linux kernel and provide it with custom command line arguments. The given page has also a number of switches, with which you can manage things like localhost forwarding, page reporing, GUI applications (WSLg) support, debug console, nested virtualization. Don't worry if you get lost - you can always just 'Revert to defaults'.

We've added a functionality to register currently or previously used WSL distros using their .vhdx file. Going further down the rabbit hole, we've turned it into more advanced feature - easyWSL can now make snapshots, which can easily be used as a backups/restore points for your distros.

https://user-images.githubusercontent.com/40501814/161391108-42a4e891-99da-4d36-a49d-3960dff28410.mp4

We've added several experimental features as well. One of them, is creating a new user at the time of installing a distro. You now can set the username and password, and, if you want to, use experimental integration of .

Versions
0.1.8.0
Website
github.com
License
Last Updated
5/15/2025

Available for installation via winget, easyWSL is a versatile tool for anyone looking to enhance their Windows experience with Linux functionality.

WSL-Hello-sudo

Furthermore, you can use an experimental feature to install development environments during the install process. This includes environments such as Python, Node.js, C/C++ and more. Not to mention, that it works cross-distro and more can be added along the way.

https://user-images.githubusercontent.com/40501814/161391121-e76dc012-b819-434b-acb2-0d2696862911.mp4

How to get it?

Just go to our Microsoft Store page, which you can find here. Get it, install, and voilà!

Building on your own

Prerequisites

  • Windows 10 1607 or later (for WSL1) or Windows 10 1903 (18362) or later
    • Note: you might want to check instructions on how to enable WSL here
  • Developer Mode enabled
  • Visual Studio 2022 (recommended by Microsoft)
  • The following workloads:
    • .NET Desktop Development
  • Individual components:
    • Windows 10 SDK (10.0.19041.0)
  • The following extensions:
    • System.Text.Json

More detailed info, including building on older releases of Visual Studio, can be found here

(Upon opening the repo in Visual Studio, it will prompt you to install any missing workloads and features.)

Building

We currently only build using the solution; command line methods of building a VS solution should work as well.

Future plans

CLI

We are looking forward to make a CLI compatible with all of our latest features, in order to make our tool usable in scripts.

If you're looking into using easyWSL as a CLI, the only current option is to use the older version (easyWSL 1.2), which you can get from the release page here.