Microsoft liefert wslc.exe mit dem Windows-Subsystem für Linux (WSL) aus. Damit können Sie unter Windows 11 Linux-Container starten und eigene Container-Images bauen, ohne eine separate Container-Engine zu installieren. Für den Einstieg aktualisieren Sie WSL, prüfen wslc und starten den Testcontainer hello-world.

Was wslc unter Windows 11 ermöglicht

wslc ist ein Befehlszeilenprogramm für Linux-Container, das Microsoft in WSL integriert. Der Ablauf reicht vom Abruf eines fertigen Images bis zum Bau eines eigenen Container-Images aus einer Containerfile. Die Microsoft-Anleitung zu Containern mit WSL führt durch Einrichtung, Start, Portfreigabe und Verwaltung.

WSL einrichten und wslc prüfen

Installiere WSL nur, wenn es fehlt, aktualisiere es und prüfe wslc anschließend mit einem Linux-Testcontainer.

Sie benötigen WSL, bevor Sie wslc verwenden. Wenn WSL noch nicht installiert ist, nennt XDA wsl --install als ersten Schritt. Anschließend empfiehlt Microsoft, WSL zu aktualisieren und die Befehlszeilenschnittstelle zu prüfen.

  1. Installieren Sie WSL, falls es fehlt. Auf einem PC ohne WSL können Sie laut XDA mit wsl --install beginnen.
  2. Aktualisieren Sie WSL. Führen Sie in PowerShell wsl --update aus.
  3. Prüfen Sie wslc. Geben Sie wslc version ein. Die Versionsausgabe zeigt, dass der Befehl aufgerufen werden kann.

Den ersten Container starten

Der englischsprachige Rundgang von Gary Explains zeigt WSL-Containerbefehle in PowerShell. Die Aufnahme vom 2. Juli 2026 verwendet Update-Flags für eine Vorabversion.

Mit wslc run --rm hello-world starten Sie den Testcontainer. Ist das Image noch nicht lokal vorhanden, lädt wslc es automatisch herunter. Die Option --rm entfernt den Container, sobald er beendet ist.

Ein Projekt-Image bauen und einen Dienst erreichbar machen

Für einen eigenen Dienst können Sie zunächst einen Container mit einem fertigen Image starten. Microsofts Nginx-Beispiel veröffentlicht den Windows-Port 8080 am Container-Port 80:

wslc run -d --rm -p 8080:80 --name web nginx

Rufen Sie anschließend curl localhost:8080 auf, um den Dienst von Windows aus zu prüfen. wslc container list zeigt laufende Container.

Für ein eigenes Projekt führen Sie den Build und Start in mehreren Schritten aus:

  1. Legen Sie eine Containerfile im Projektverzeichnis an. Sie beschreibt das Container-Image, das aus dem Projekt gebaut werden soll.
  2. Bauen Sie das Image im Projektverzeichnis. Microsofts Beispiel verwendet wslc build -t helloworld-django ..
  3. Starten Sie den Container mit freigegebenem Port. Das dokumentierte Beispiel lautet wslc run -d --rm -p 8000:8000 --name django helloworld-django.
  4. Prüfen Sie den Dienst unter Windows. Öffnen Sie http://localhost:8000/ im Browser. Damit testen Sie den veröffentlichten Port von Windows aus.

Container prüfen, stoppen und aufräumen

Während der Container läuft, können Sie mit wslc container logs django seine Protokolle ansehen. wslc container inspect liefert Details zum Container; wslc image inspect prüft ein Image. Mit wslc exec django uname führen Sie den Befehl uname im laufenden Container aus.

Zum Beenden verwenden Sie wslc container stop django. Da das Startbeispiel --rm enthält, wird der Container anschließend entfernt. Microsoft dokumentiert außerdem wslc container prune zum Entfernen gestoppter Container und wslc image prune zum Löschen ungenutzter Images.

Liegen Projektdateien auf dem Windows-Dateisystem, kann der Dateizugriff deutlich langsamer sein, wenn Linux-Werkzeuge sie in einer WSL-Distribution verwenden. Microsoft empfiehlt deshalb, Linux-Projekte im Linux-Dateisystem abzulegen.

Was ein berichteter GPU-Test ergab

In einem Bericht vom 23. Oktober 2026 schilderte XDA-Autor Abhinav Raj einen GPU-Test mit einem Ryzen 5 7600X und einer NVIDIA RTX 4070 Ti Super mit 16 GB VRAM. Die CUDA-Umgebung nvidia/cuda:12.9.1-base-ubuntu24.04 erkannte laut Bericht die Grafikkarte und den NVIDIA-Treiber 617.14.

Beim llama.cpp-Test mit Gemma 4 E4B erreichte der Container in beiden Läufen 124 Tokens pro Sekunde. Die nativen Läufe kamen auf 128 bis 132 Tokens pro Sekunde. Verwendet wurden Q4_K_M-Quantisierung, vollständige GPU-Auslastung, ein 128K-Kontext, derselbe Prompt und eine Antwort mit 256 Tokens. Das sind die Ergebnisse von Rajs zwei Läufen je Ausführungsart auf dieser konkreten Konfiguration.

Wo die Grenzen von wslc liegen

XDA beschrieb wslc in seinem Bericht als Werkzeug für Linux-Container. Wenn Sie Windows-Container ausführen müssen, passt dieser Ablauf daher nicht zu dieser Aufgabe. Microsofts Anleitung behandelt den Bau und Betrieb von Linux-Containern.