WSL Distro Manager

A quick way to manage your WSL instances with a GUI.

Made with Flutter and fluent_ui based on Windows design guidelines.

Here is how it looks in Lightmode if you are into that.

Install

You can get it here for $4.99.

or

this app is available on the Windows Store.

or

as a direct download from the Releases page.

or

winget install Bostrot.WSLManager (outdated version)

Build

Enable Flutter Desktop flutter config --enable-windows-desktop (https://flutter.dev/desktop)

flutter upgrade

Run with flutter run -d windows and build with flutter build windows

Why

WSL is great. It makes it very simple to spin up new workplaces with different systems for the project you need or just testing.

How to use

Fairly simple. Download the latest release from the releases Page and start wsl2distromanager.exe

Features

• Starting the program. YAY!
• 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
• List WSL
• Copy WSL
• Delete WSL
• Start WSL
• Rename WSL
• Create WSL
• Download WSL
• Select rootfs from storage
• and more but I am tired of writing already ... Feel free to open a PR.

What works

• [x] Starting the program. YAY!
• [X] Quick Actions
• [x] List WSL
• [x] Copy WSL
• [x] Delete WSL
• [x] Start WSL
• [X] Rename WSL
• [X] Create WSL
• [X] Download WSL
• [X] Select rootfs from storage
• [X] Use turnkey/LXC images as base

FAQ

How do I access my Turnkey instance? (e.g. Wordpress)

Turnkey instances can be inited with turnkey-init in console. This will let you choose new passwords for your services.

What does it mean that it installs "fake_systemd" with Turnkey?

As systemd is not officially supported in WSL (yet) fake_systemd is a custom fork from @kvaps specifically for WSL so that Turnkey services will actually startup when opening the instance.

Contribute

You are very welcome to contribute to this project in order to make it better.

Docs

Currently only the WSL API is documented with dart doc. You can find the documentation here.

Code contributions

If you have made a code contribution feel free to open a PR and/or an issue.

Language contributions

Localizations are saved in /lib/i18n/ as json files. New languages can be added either directly in the appropriate json file (e.g. en.json) or via the localizations windows/mac application which provides a GUI.

As of some restrictions with fluent_ui package currently it is easier not to use the country code in the file name so instead of en_US.json just en.json.

Feel free to publish a PR :)

Help

You need more help but the FAQ did not help?

Contact me on Telegram @bostrot_bot.

Or just open an issue here.

Stuff

Create signed msix package

(Only for maintainers with build certificate)

To create a signed msix package set the .githooks directory as your git hooks directory:

git config --local core.hooksPath .githooks/

Then it will update version numbers, build sign and commit everything with the push. This will take the configuration from the file certs/pubspec.yaml and replace the version (xxx in the pubspec.yaml) with the current version from the running pubspec file.

You can also sign it manually by adding the msix config to the end of the pubspec.yaml file and then run flutter pub run msix:create

This project is made with Flutter for Desktop :)