Willkommen bei WSL Manager đ
[](https://github.com/bostrot/wslmanager/wiki)
[](https://gitlab.com/bostrot/wsl2-distro-manager)
[](https://discord.gg/fY5uE5WRTP)
English | çźäœäžæ | çčé«äžæ | Deutsch | Español | æ„æŹèȘ | Magyar | PortuguĂȘs | TĂŒrkçe
Gezeigt unter Windows · dieselbe App verwaltet native VMs unter macOS — siehe Unter macOS ansehen weiter unten
Vorschau mit hellem Design (Windows)
đ Unter macOS ansehen — native Linux- und macOS-VMs ĂŒber Apples Virtualization-Framework (Beta)
> **WSL Distro Manager** ist eine kostenlose, quelloffene grafische OberflÀche
> fĂŒr das Windows Subsystem fĂŒr Linux â und unter macOS fĂŒr native Linux-VMs.
> Installieren, kopieren, umbenennen, verschieben, sichern und löschen Sie
> WSL-Distributionen, ohne sich eine einzige `wsl.exe`-Option merken zu mĂŒssen
> â dazu Vorlagen, gespeicherte Befehls-Snippets, das Einbinden von
> DatentrÀgern, das Bearbeiten von `.wslconfig`, WSL per SSH aus der Ferne und
> ein MCP-Server, ĂŒber den KI-Agenten Ihre WSL-Umgebung steuern können. Auf
> einem Mac verwaltet genau dieselbe App stattdessen virtuelle Maschinen ĂŒber
> Apples Virtualization-Framework.
## đ Funktionen
**Distributionen verwalten**
- [x] Installation aus einem eingebauten Katalog oder mit Ihrem eigenen rootfs
- [x] Instanzen kopieren, umbenennen, auf ein anderes Laufwerk verschieben, sichern und löschen
- [x] Alle Instanzen in einen Ordner sichern â samt Liste, was darin liegt â und auf einem anderen PC wiederherstellen
- [x] Virtuelle DatentrĂ€ger komprimieren und Platz zurĂŒckholen, den WSL nie wieder freigibt
- [x] UnterstĂŒtzt Ubuntu, Debian, Alpine, Kali Linux, openSUSE, SLES und alles andere, was WSL akzeptiert
**Instanzen schneller startklar bekommen**
- [x] Jedes Docker-Image als Distribution nutzen â Docker selbst wird nicht benötigt
- [x] Eine eingerichtete Distribution als portable `.wsl`-Datei verpacken, die sich auf jedem Rechner installieren lÀsst (Vorlagen sind zugunsten dieser Dateien veraltet)
- [x] Turnkey Linux und andere LXC-Container (experimentell)
- [x] Snippets: Ihre Einrichtungsbefehle in der App behalten und auf jeder Instanz ausfĂŒhren
- [x] Die App auf Ihr eigenes Repository mit rootfs-Images zeigen lassen
- [x] Die Dateien einer Distro durchsehen und die ausgewĂ€hlten in eine andere Instanz kopieren â ohne Freigabe, ohne Mount, ohne Explorer
**Konfigurieren, ohne Dateien von Hand zu bearbeiten**
- [x] systemd, automount, Standardbenutzer, Startbefehl und Startpfad je Distribution
- [x] Arbeitsspeicher, Prozessoren, Swap, Netzwerkmodus, DNS und der Rest von `.wslconfig`
- [x] Einen physischen DatentrĂ€ger oder eine VHD in WSL einbinden, mit Kontrolle ĂŒber Partition und Dateisystem
- [x] Host-Ordner unter einem frei gewĂ€hlten EinhĂ€ngepunkt in eine Distro oder VM freigeben, auf Wunsch schreibgeschĂŒtzt â auch fĂŒr den AI Workspace
**So arbeiten, wie Sie es ohnehin tun**
- [x] Windows Terminal, VS Code oder den Explorer direkt in einer Distribution öffnen
- [x] Jede Instanz im Windows-Terminal-MenĂŒ, aktuell gehalten, solange die App lĂ€uft â als eigenes Fragment beigesteuert, sodass Ihre Terminal-Einstellungen nie verĂ€ndert werden
- [x] WSL auf einem *anderen* Windows-Rechner per SSH verwalten
- [x] Eine Distribution zwischen zwei Rechnern im Netzwerk abgleichen
- [x] Instanzen ĂŒber ihren Namen erreichen: der Hostname wird in der hosts-Datei gepflegt, `ssh ubuntu.wsl` funktioniert also auch nach einem Neustart
- [x] HĂ€lt sich selbst aktuell: die Website- und GitHub-Builds laden neue Versionen selbst herunter und installieren sie (Store-Installationen werden vom Store aktualisiert)
- [x] Dunkles und helles Design, verfĂŒgbar in neun Sprachen
**Unter macOS: native virtuelle Maschinen** *(Beta)*
- [x] Dieselbe App verwaltet VMs ĂŒber Apples Virtualization-Framework statt ĂŒber WSL
- [x] Linux-VMs aus einer Installations-ISO, einem Cloud-Image oder einer exportierten Vorlage erstellen
- [x] macOS-Gast-VMs aus einem Restore-Image erstellen (Apple Silicon)
- [x] VMs wie Distributionen starten, stoppen, klonen, exportieren/importieren und als Vorlage sichern
- [x] Befehle in VMs ĂŒber automatisch eingerichtetes SSH (cloud-init) ausfĂŒhren â aus der OberflĂ€che, dem KI-Chat oder von MCP-Clients
- [x] Ein Terminal zu jeder VM direkt aus ihrer Zeile: eine SSH-Sitzung im Linux- oder macOS-Gast, die serielle Konsole, wenn es bei Linux nichts zum Verbinden gibt
- [x] Ihr eigener `~/.ssh`-SchlĂŒssel wird in jeder Linux-VM autorisiert (und angelegt, falls Sie keinen haben), sodass auch schlicht `ssh user@vm-ip` funktioniert
- [x] Jede VM bekommt ein Anmeldekennwort, das Sie in ihrer Zeile nachlesen können, um sich am Bildschirm der VM selbst anzumelden
- [x] Das Konto, mit dem sich jeder SSH-Weg anmeldet, lĂ€sst sich in derselben Zeile festlegen â der Name eines macOS-Gasts wird im Systemassistenten eingegeben, wo die App ihn nicht sieht
- [x] Bauen mit `scripts/build_macos.sh` â bĂŒndelt den signierten `vmctl`-Helfer
**Pro** *(einmaliger Kauf: Microsoft Store unter Windows, LizenzschlĂŒssel von [wslmanager.com/buy](https://wslmanager.com/buy/) unter macOS und fĂŒr Installationen auĂerhalb des Stores â niemals ein Abonnement)*
- [x] **AI Workspace** â Hermes Agent, OpenClaw, Open WebUI und OpenCode in einer eigenen, isolierten WSL-Distribution betreiben
- [x] **Ein Modell und Endpunkt fĂŒr alle KI-Tools** â API-Endpunkt, SchlĂŒssel und Modell des KI-Assistenten aus den Einstellungen verwenden auch OpenCode, OpenClaw und Hermes; einmal festlegen, und ein spĂ€ter installiertes Tool erhĂ€lt sie ebenfalls
- [x] **KI-Assistent mit Werkzeugen** â der eingebaute Chat kann Ihr WSL wirklich *bedienen*: er listet und untersucht Distributionen, fĂŒhrt Befehle aus, bearbeitet die Konfiguration, legt Snippets an, bindet DatentrĂ€ger ein und verpackt Distributionen ĂŒber dieselben Werkzeuge, die der MCP-Server bereitstellt
- [x] **Jeder KI-Lauf, der eine Instanz verĂ€ndert, wird als Snippet gespeichert** â mit den ausgefĂŒhrten Befehlen und dem, was jedes Werkzeug gemeldet hat, verlinkt aus dem Chat, damit Sie ihn prĂŒfen, auf einer frischen Instanz erneut ausfĂŒhren oder teilen können
- [x] **KI in der Sandbox** â eine Wegwerf-Ubuntu-Distribution hochziehen und einem KI-Chat Zugriff *nur* auf das Innere dieser Sandbox geben
- [x] **Aufgabenliste** â geben Sie dem Assistenten eine Liste und lassen Sie ihn sie abarbeiten, Punkt fĂŒr Punkt abgehakt
- [x] **MCP-Server** â WSL fĂŒr Claude Desktop, Claude Code, opencode und andere MCP-Clients verfĂŒgbar machen
- [x] **Web-Dashboard** â alles vom Telefon oder einem anderen Rechner aus verwalten: QR-Code scannen, die ganze App im Browser bekommen, auf Wunsch ĂŒber einen Cloudflare-Tunnel auch auĂerhalb Ihres Netzwerks
> Die KI-Funktionen laufen mit Zugangsdaten, die **Sie** mitbringen â Ihrem
> eigenen OpenAI-kompatiblen API-SchlĂŒssel. Es wird kein KI-Dienst gehostet
> oder mitgeliefert, es gibt kein Kontingent, und keine Anfrage lĂ€uft ĂŒber
> fremde Server. Pro schaltet die Funktionen in der App frei; es kauft kein
> KI-Guthaben. Siehe [Free vs Pro](https://github.com/bostrot/wslmanager/wiki/Pro-Version).
> **Warum gibt es ĂŒberhaupt eine kostenpflichtige Stufe?** WSL Manager ist seit
> 2021 ein Ein-Personen-Projekt in der Freizeit, und jede Funktion oben â die
> kostenlosen eingeschlossen â entstand an Abenden und Wochenenden. Ihre
> Distributionen und VMs zu verwalten ist kostenlos und bleibt es, und die
> ganze App bleibt quelloffen. Pro ist die KI-Schicht obendrauf, und was sie
> einbringt, macht aus Wartung und neuen Funktionen geplante, regelmĂ€Ăige
> Arbeit statt dessen, was an Zeit ĂŒbrig bleibt. Einmal kaufen, fĂŒr immer
> behalten â und Sie finanzieren direkt die nĂ€chste Version.
> đ **Zum Start â die ersten 100 Personen bekommen Pro kostenlos.** Ăffnen Sie
> die Kasse mit bereits eingetragenem Code `START100`, und Ihr LizenzschlĂŒssel
> steht auf der nÀchsten Seite: [**Windows**](https://buy.stripe.com/5kQeVd6ECgur3wJ2TO1Fe03?prefilled_promo_code=START100) ·
> [**macOS**](https://buy.stripe.com/dRm00jbYWfqnaZb1PK1Fe02?prefilled_promo_code=START100).
> Eine Lizenz pro Person; sind die 100 vergeben, funktioniert der Code nicht mehr.
## đ€ KI-Assistent & MCP *(Pro)*
Alles in diesem Abschnitt gehört zu **Pro**; die kostenlose App hat davon nichts.
Der KI-Assistent ist ein **Agent**, nicht bloĂ ein Chatfenster: er bekommt
denselben Werkzeugsatz, den der MCP-Server bereitstellt. Fragen Sie âwelche
Distributionen habe ich?â oder âinstalliere Ubuntu und setze meinen
Standardbenutzerâ, ruft er echte Werkzeuge gegen Ihr WSL auf, statt zu raten.
Werkzeugaufrufe werden wÀhrend der Arbeit direkt angezeigt.
**Den Anbieter einrichten** unter **Einstellungen â Bring Your Own AI Key**:
jeder OpenAI-kompatible Endpunkt funktioniert (OpenAI, Azure, ein
LiteLLM-Proxy, Ollama, LM Studio, âŠ). Tragen Sie Basis-URL, SchlĂŒssel und
Modell ein. Die SchaltflĂ€che **Modellliste laden** fĂŒllt eine
AutovervollstÀndigung aus dem `/models`-Endpunkt des Anbieters, und
**Verbindung testen** belegt, dass die Zugangsdaten stimmen, bevor Sie den Chat
öffnen.
**Nichts davon gewĂŒnscht?** **Einstellungen â Bring Your Own AI Key â KI-Funktionen** schaltet den Assistenten, die Fehlerdiagnose und den AI Workspace aus â nichts KI-Bezogenes wird angezeigt, und es wird keine Workspace-Umgebung fĂŒr Sie eingerichtet. Er ist aus, bis Sie geantwortet haben: WSL Manager fragt einmal, beim ersten Start nach Installation oder Update, und vorher lĂ€uft nichts KI-Bezogenes.
**Sandboxes** (AI Workspace â *Sandbox-Distribution hinzufĂŒgen*) erzeugen eine
Wegwerf-Instanz aus einem beliebigen Katalog-Image (standardmĂ€Ăig das neueste
Ubuntu) â unter Windows eine WSL-Distribution, unter macOS eine aus einem
Cloud-Image erstellte Linux-VM, die fĂŒr Sie angelegt und gestartet wird. Ihrem
Chat werden nur die `sandbox_*`-Werkzeuge gegeben, die auf genau diese eine
Instanz beschrĂ€nkt sind â das Modell darf alles *innerhalb* der Sandbox tun und
sieht nie Ihren Host oder eine andere Instanz. Ein ehrlicher Vorbehalt: die
Sandbox selbst hat normalen Internetzugang nach auĂen, wie jede Distribution
oder VM. Sandbox-Chats nutzen dasselbe angedockte Panel wie der Assistent
(inklusive Aufgabenliste), ihre VerlÀufe bleiben erhalten, und die
VerlaufsschaltflÀche in der Kopfzeile des Chats wechselt zwischen dem
Assistenten und jeder Sandbox-Sitzung.
**Aufgabenliste** â öffnen Sie den Abschnitt *Aufgaben* oben im Chat, tragen Sie
Punkte ein und drĂŒcken Sie â¶. Der Assistent arbeitet sie mit seinen Werkzeugen
ab und hakt jeden Punkt ab, sobald er fertig ist; Sie können wÀhrenddessen
weitere Aufgaben hinzufĂŒgen.
### Externe KI-Clients anbinden (MCP)
Schalten Sie **Einstellungen â MCP-Server** ein (Pro). Er stellt das
MCP-Protokoll unter `http://127.0.0.1:59133/mcp` bereit, nur ĂŒber das
Loopback-Interface und geschĂŒtzt durch ein Bearer-Token, das im selben Panel
angezeigt wird. Die Werkzeuge decken den gesamten Lebenszyklus ab â anlegen,
importieren, konfigurieren, ausfĂŒhren, verpacken und (mit einem
BestÀtigungs-Flag) abmelden von Distributionen, dazu Snippets, das Einbinden von
DatentrÀgern und dauerhafte Terminalsitzungen.
**Claude Desktop** â klicken Sie im MCP-Panel auf **Claude Desktop verbinden**.
Der untenstehende Eintrag wird fĂŒr Sie in `claude_desktop_config.json`
geschrieben (benötigt Node.js); starten Sie Claude Desktop danach neu. Von Hand,
oder fĂŒr jeden anderen stdio-MCP-Client, ĂŒberbrĂŒcken Sie den HTTP-Endpunkt mit
[`mcp-remote`](https://www.npmjs.com/package/mcp-remote):
```jsonc
// claude_desktop_config.json (%APPDATA%\Claude\)
{
"mcpServers": {
"wsl-manager": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"http://127.0.0.1:59133/mcp",
"--header", "Authorization:${AUTH_HEADER}"
],
"env": { "AUTH_HEADER": "Bearer " }
}
}
}
```
**Claude Code** â dieselbe BrĂŒcke, ein Befehl:
```bash
claude mcp add wsl-manager -- npx -y mcp-remote http://127.0.0.1:59133/mcp \
--header "Authorization: Bearer "
```
**opencode** â tragen Sie es unter `mcp` in Ihrer `opencode.json` (oder `~/.config/opencode/opencode.json`) ein:
```jsonc
{
"mcp": {
"wsl-manager": {
"type": "local",
"command": ["npx", "-y", "mcp-remote", "http://127.0.0.1:59133/mcp",
"--header", "Authorization: Bearer "]
}
}
}
```
Jeder MCP-Client, der streamable HTTP spricht, kann auch direkt auf den Endpunkt
zeigen und dabei einen `Authorization: Bearer `-Header mitschicken, ganz
ohne `mcp-remote`. Um ihn von einem anderen Rechner aus zu erreichen, schalten
Sie im selben Panel den eingebauten **Cloudflare-Tunnel** ein und verwenden die
öffentliche URL, die er ausgibt.
## đ± Web-Dashboard *(Pro)*
Schalten Sie **Einstellungen â Web-Dashboard** ein (Pro), und die App liefert
fĂŒr jedes GerĂ€t in Ihrem Netzwerk ein Browser-Dashboard auf Port `59134` aus â
unter Windows wie unter macOS. Scannen Sie den QR-Code aus dem Panel mit Ihrem
Telefon (oder kopieren Sie den Link), und Sie haben die ganze App im Browser:
Instanzen starten, stoppen, duplizieren und löschen, Befehle ausfĂŒhren,
dauerhafte Terminalsitzungen öffnen, Ihre gespeicherten Snippets ausfĂŒhren und
jedes weitere Werkzeug (Import, Export, Verpacken, `.wslconfig`, DatentrÀger,
VM-Erstellung) ĂŒber generierte Formulare bedienen. Es ist derselbe
Werkzeugsatz, den der KI-Assistent und der MCP-Server verwenden.
Der Zugriff ist durch ein Token geschĂŒtzt, das Teil des Links ist (`?token=âŠ`),
sodass ein gescannter QR-Code alles ist, was ein GerĂ€t braucht â und ein neu
erzeugtes Token im Panel entwertet jeden bisher herausgegebenen Link. Das
Dashboard lauscht absichtlich auf allen Schnittstellen; schalten Sie im selben
Panel **Ăber Cloudflare-Tunnel veröffentlichen** um, wenn Sie unterwegs einen
temporÀren öffentlichen HTTPS-Link brauchen (der QR-Code wechselt dann darauf).
Einmal veröffentlicht, ist das Token das Einzige, was eine OberflĂ€che schĂŒtzt,
die Befehle ausfĂŒhren kann â teilen Sie diesen Link also mit Bedacht.
## đŠ Installieren
Microsoft Store
Diese App ist im [Microsoft Store](https://apps.microsoft.com/store/detail/wsl-manager/9NWS9K95NMJB?hl=en-us&gl=US) erhÀltlich.
macOS ĂŒber Homebrew
```sh
brew install --cask wsl-manager
```
Apple Silicon, macOS 11 oder neuer. Das Cask ist in Homebrew selbst enthalten, ein Tap ist also nicht nötig; `brew upgrade --cask wsl-manager` holt neue Versionen.
Direkter Download
Sie bekommen diese App als direkten Download von der Seite [Releases](https://github.com/bostrot/wslmanager/releases). Windows wird als Setup-`.exe`, als `.msix` und als portables `.zip` ausgeliefert; macOS als `.dmg`.
Installation ĂŒber Winget
```sh
winget install Bostrot.WSLManager
```
Installation ĂŒber Scoop
```sh
scoop install extras/wsl2-distro-manager
```
Installation ĂŒber Chocolatey
Dieses Paket wird von der Community gepflegt ([@mikeee](https://github.com/mikeee/ChocoPackages)). Es ist kein offizielles Paket.
```sh
choco install wsl2-distro-manager
```
Einen Nightly-Build installieren
Der letzte Nightly-Build ist als Artefakt im âreleaserâ-Workflow oder ĂŒber [diesen Link](https://nightly.link/bostrot/wslmanager/workflows/releaser/main/wsl2-distro-manager-nightly-archive.zip) verfĂŒgbar.
## âïž Build
Stellen Sie sicher, dass [flutter](https://flutter.dev/desktop) installiert ist.
### Windows
```powershell
flutter config --enable-windows-desktop
flutter upgrade
flutter build windows # build it
flutter run -d windows # run it
```
### macOS
VMs werden von `vmctl` erstellt, einem kleinen Swift-Helfer, der
Virtualization.framework steuert â nicht von der Flutter-App selbst. Das
Framework antwortet nur Prozessen, die die Berechtigung
`com.apple.security.virtualization` tragen, und `swift build` fĂŒgt sie nicht
hinzu. **Der Helfer muss also gebaut und signiert sein, bevor die App eine VM
starten kann**:
```bash
flutter config --enable-macos-desktop
# Build + sign vmctl and install it for dev runs. Re-run after any change
# under macos/vmctl/ â `flutter run` never rebuilds the helper.
VMCTL_ONLY=1 scripts/build_macos.sh
flutter run -d macos
```
LĂ€sst man diesen Schritt aus, startet die App zwar, aber das Starten einer VM
scheitert mit:
```
VM failed to start: Error Domain=VZErrorDomain Code=2 "The process doesn't
have the "com.apple.security.virtualization" entitlement."
```
Das ist der *Helfer* ohne Berechtigung, nicht die App â die Berechtigungen von
`Runner` selbst stimmen bereits. Der signierte Helfer wird nach
`~/Library/Application Support/WSLManager/bin/vmctl` installiert, und genau dort
suchen Debug-LĂ€ufe; fehlt er, greifen sie auf die unsignierte Ausgabe von
`swift build` unter `macos/vmctl/.build/` zurĂŒck â was den obigen Fehler
erzeugt.
`scripts/build_macos.sh` ohne `VMCTL_ONLY` signiert genauso und baut danach die
Release-App, wobei der signierte Helfer in `Contents/Resources/` des Bundles
mitgeliefert wird. FĂŒr den Bau der App selbst wird das vollstĂ€ndige Xcode
benötigt.
## Autor
đ€ **Eric Trenkel**
- Website: [erictrenkel.com](https://erictrenkel.com)
- GitHub: [@bostrot](https://github.com/bostrot)
- LinkedIn: [@erictrenkel](https://linkedin.com/in/erictrenkel)
đ„ **Mitwirkende**
[](https://github.com/bostrot/wslmanager/graphs/contributors)
## đ€ Mitmachen
BeitrĂ€ge, Fehlerberichte und FunktionswĂŒnsche sind willkommen!\
Schauen Sie gern auf der [Issues-Seite](https://github.com/bostrot/wslmanager/issues) vorbei.
Ein Blick in den [Contributing Guide](https://github.com/bostrot/wslmanager/blob/main/CONTRIBUTING.md) lohnt sich ebenfalls.
## Zeigen Sie Ihre UnterstĂŒtzung
Geben Sie ein âïž, wenn Ihnen dieses Projekt geholfen hat!
## đ Lizenz
Copyright © 2026 [Eric Trenkel](https://github.com/bostrot).\
Dieses Projekt ist [GPL-3.0](https://github.com/bostrot/wslmanager/blob/main/LICENSE)-lizenziert.
---
_Nicht gefunden, wonach Sie gesucht haben? Schauen Sie ins [Wiki](https://github.com/bostrot/wslmanager/wiki)_