/wsl2-distro-manager

A GUI to quickly manage your WSL2 instances

Primary LanguageDartOtherNOASSERTION

Welcome to WSL Manager 👋

GitHub Release Date GitHub Workflow GitHub release (latest by date) Documentation GitLab stars Discord

English | 简体中文 | Deutsch | Español

Screenshot with Darkmode

Preview with Lightmode

Screenshot with Lightmode

WSL Distro Manager is a free and open source app that provides a user-friendly graphical interface for managing Windows Subsystem for Linux (WSL) distributions. With WSL Distro Manager, you can easily install, uninstall, update, backup and restore WSL distros, as well as configure their settings and launch them with a single click. WSL Distro Manager also offers some extra features to enhance your WSL experience, such as sharing Distros between multiple machines, and creating actions to quickly do repetitive tasks. Whether you are a beginner or an expert in WSL, WSL Distro Manager will help you get the most out of it.

🚀 Features

  • Manage WSL instances
  • Download and use Docker images as WSL instances - without Docker!
  • Quick Actions (execute pre-defined scripts directly on your instances for quick configurations)
  • Download and use Turnkey or other LXC containers (experimental, tested with e.g. Turnkey WordPress)
  • Use your own repository for rootfs' or LXC containers
  • and more...

📦 Install

Microsoft Store

This app is available on the Microsoft Store.

Direct download

You can get this app with a direct download from the Releases page. The latest version is available as a zip file.

Install via Winget

The winget package is outdated! Please use the Windows Store version instead.

winget install Bostrot.WSLManager
Install via Chocolatey

This package is maintained by the community (@mikeee). It is not an official package.

choco install wsl2-distro-manager
Install a nightly build

The last build can be found as artifacts in the "releaser" workflow or via this link. If you rather prefer an unsigned msix you can also use this link.

⚙️ Build

Make sure flutter is installed:

flutter config --enable-windows-desktop
flutter upgrade

flutter build windows # build it
flutter run -d windows # run it

Author

👤 Eric Trenkel

👥 Contributors

Contributors

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check the issues page. You can also take a look at the contributing guide.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2023 Eric Trenkel.
This project is GPL-3.0 licensed.

Not found what you were looking for? Check out the Wiki