# Welcome to WSL Manager 👋

English | 简体中文 | Deutsch

Preview 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

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

## 📦 Install

Microsoft Store

This app is available on the Microsoft Store.
If you don't want to support this project by paying for it you can get a key when you join our Discord community and write `/key` into the `codes` channel!

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

- Website: erictrenkel.com
- Github: @bostrot
- LinkedIn: @erictrenkel

👥 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

## Libraries

actions_screen
app
base_dialog
bug_dialog
changelog_dialog
constants
copy_dialog
create_dialog
dialogs
docker_images
  API to download docker images from DockerHub and extract them into a rootfs.
firststart_dialog
helpers
home_screen
hoverable
info_dialog
init
install_dialog
linkaction
list
list_item
logging
  Simple file-based logging and error reporting
main
navbar
notify
oss_licenses
panelist
qa_dialog
qa_list
quick_actions
root_screen
router
safe_paths
settings_dialog
settings_screen
sync
template_screen
templates
theme
wsl
wsl2distromanager.analytics