Willkommen bei WSL Manager 👋

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}

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

• Installation aus einem eingebauten Katalog oder mit Ihrem eigenen rootfs
• Instanzen kopieren, umbenennen, auf ein anderes Laufwerk verschieben, sichern und löschen
• Alle Instanzen in einen Ordner sichern – samt Liste, was darin liegt – und auf einem anderen PC wiederherstellen
• Virtuelle Datenträger komprimieren und Platz zurückholen, den WSL nie wieder freigibt
• Sehen, was eine Instanz gerade verbraucht – Rechenzeit, Arbeitsspeicher und Swap, mit laufendem Diagramm
• Unterstützt Ubuntu, Debian, Alpine, Kali Linux, openSUSE, SLES und alles andere, was WSL akzeptiert

Instanzen schneller startklar bekommen

• Jedes Docker-Image als Distribution nutzen — Docker selbst wird nicht benötigt
• Eine eingerichtete Distribution als portable .wsl-Datei verpacken, die sich auf jedem Rechner installieren lässt (Vorlagen sind zugunsten dieser Dateien veraltet)
• Turnkey Linux und andere LXC-Container (experimentell)
• Snippets: Ihre Einrichtungsbefehle in der App behalten und auf jeder Instanz ausführen
• Die App auf Ihr eigenes Repository mit rootfs-Images zeigen lassen
• 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

• systemd, automount, Standardbenutzer, Startbefehl und Startpfad je Distribution
• Arbeitsspeicher, Prozessoren, Swap, Netzwerkmodus, DNS und der Rest von .wslconfig
• Einen physischen Datenträger oder eine VHD in WSL einbinden, mit Kontrolle über Partition und Dateisystem
• 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

• Windows Terminal, VS Code oder den Explorer direkt in einer Distribution öffnen
• 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
• WSL auf einem anderen Windows-Rechner per SSH verwalten
• Eine Distribution zwischen zwei Rechnern im Netzwerk abgleichen
• Instanzen über ihren Namen erreichen: der Hostname wird in der hosts-Datei gepflegt, ssh ubuntu.wsl funktioniert also auch nach einem Neustart
• Hält sich selbst aktuell: die Website- und GitHub-Builds laden neue Versionen selbst herunter und installieren sie (Store-Installationen werden vom Store aktualisiert)
• Dunkles und helles Design, verfügbar in neun Sprachen

Unter macOS: native virtuelle Maschinen (Beta)

• Dieselbe App verwaltet VMs über Apples Virtualization-Framework statt über WSL
• Linux-VMs aus einer Installations-ISO, einem Cloud-Image oder einer exportierten Vorlage erstellen
• macOS-Gast-VMs aus einem Restore-Image erstellen (Apple Silicon)
• VMs wie Distributionen starten, stoppen, klonen, exportieren/importieren und als Vorlage sichern
• Befehle in VMs über automatisch eingerichtetes SSH (cloud-init) ausführen — aus der Oberfläche, dem KI-Chat oder von MCP-Clients
• 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
• 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
• Jede VM bekommt ein Anmeldekennwort, das Sie in ihrer Zeile nachlesen können, um sich am Bildschirm der VM selbst anzumelden
• 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
• 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 unter macOS und für Installationen außerhalb des Stores — niemals ein Abonnement)

• AI Workspace — Hermes Agent, OpenClaw, Open WebUI und OpenCode in einer eigenen, isolierten WSL-Distribution betreiben
• 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
• 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
• 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
• KI in der Sandbox — eine Wegwerf-Ubuntu-Distribution hochziehen und einem KI-Chat Zugriff nur auf das Innere dieser Sandbox geben
• Aufgabenliste — geben Sie dem Assistenten eine Liste und lassen Sie ihn sie abarbeiten, Punkt für Punkt abgehakt
• MCP-Server — WSL für Claude Desktop, Claude Code, opencode und andere MCP-Clients verfügbar machen
• 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.

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.

🤖 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:

// 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 <TOKEN FROM THE MCP PANEL>" }
    }
  }
}

Claude Code — dieselbe Brücke, ein Befehl:

claude mcp add wsl-manager -- npx -y mcp-remote http://127.0.0.1:59133/mcp \
  --header "Authorization: Bearer <TOKEN>"

opencode — tragen Sie es unter mcp in Ihrer opencode.json (oder ~/.config/opencode/opencode.json) ein:

{
  "mcp": {
    "wsl-manager": {
      "type": "local",
      "command": ["npx", "-y", "mcp-remote", "http://127.0.0.1:59133/mcp",
                  "--header", "Authorization: Bearer <TOKEN>"]
    }
  }
}

Jeder MCP-Client, der streamable HTTP spricht, kann auch direkt auf den Endpunkt zeigen und dabei einen Authorization: Bearer <TOKEN>-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

brew install --cask wsl-manager

winget install Bostrot.WSLManager

scoop install extras/wsl2-distro-manager

choco install wsl2-distro-manager

⚙️ Build

Stellen Sie sicher, dass flutter installiert ist.

Windows

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:

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
• GitHub: @bostrot
• LinkedIn: @erictrenkel

👥 Mitwirkende

🤝 Mitmachen

Beiträge, Fehlerberichte und Funktionswünsche sind willkommen!
Schauen Sie gern auf der Issues-Seite vorbei. Ein Blick in den Contributing Guide lohnt sich ebenfalls.

Zeigen Sie Ihre Unterstützung

Geben Sie ein ⭐️, wenn Ihnen dieses Projekt geholfen hat!

📝 Lizenz

Copyright © 2026 Eric Trenkel.
Dieses Projekt ist GPL-3.0-lizenziert.

Nicht gefunden, wonach Sie gesucht haben? Schauen Sie ins Wiki