English | 简体中文
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.
This app is available on the Windows Store.
- or -
as a direct download from the Releases page.
- or -
winget install Bostrot.WSLManager (outdated version)
- or -
choco install wsl2-distro-manager (maintained by @mikeee)
The last build can be found as artificats in the "releaser" workflow or via this link.
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
- List WSL
- Copy WSL
- Delete WSL
- Start WSL
- Rename WSL
- Create WSL
- Download WSL
- Select rootfs from storage
- 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...
Turnkey instances can be inited with turnkey-init in console. This will let you choose new passwords for your services.
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.
You are very welcome to contribute to this project in order to make it better.
If you find any missing distribution that you think should be added please open a Distro request.
Currently generated API docs are available. You can find the documentation here.
If you have made a code contribution feel free to open a PR and/or an issue.
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 :)
You need more help but the FAQ did not help?
Contact me on Telegram @bostrot_bot.
Or just open an issue here.
(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
WSL is great. It makes it very simple to spin up new workplaces with different systems for the project you need or just testing.
This project is made with Flutter for Desktop :)