WSL installieren: Linux unter Windows

01Was ist WSL und wozu dient es?

WSL (Windows Subsystem for Linux), auf Deutsch das Windows-Subsystem für Linux, ist ein Microsoft-Feature, mit dem Sie innerhalb von Windows eine echte Linux-Umgebung betreiben. Ohne virtuelle Maschine und ohne Dual-Boot öffnen Sie ein Ubuntu-Terminal, installieren Pakete mit apt und führen Bash-Skripte aus.

In der Webentwicklung laufen die allermeisten Server unter Linux. Ähnelt Ihre Entwicklungsumgebung dem Produktivserver, vermeiden Sie von vornherein Fehler bei Dateipfaden, Berechtigungen und Groß-/Kleinschreibung, die sonst erst live auftauchen. Node.js, Python, PHP, Ruby und die meisten Datenbank-Tools lassen sich unter Linux reibungsloser installieren.

Der Unterschied zwischen WSL 1 und WSL 2

WSL 2 führt in einer leichtgewichtigen virtuellen Maschine einen echten Linux-Kernel aus. Dadurch laufen Tools wie Docker, die Kernel-Funktionen benötigen, und Vorgänge im Linux-Dateisystem sind sehr schnell. WSL 1 übersetzt dagegen Linux-Aufrufe für Windows; beim Zugriff auf Windows-Dateien ist es mitunter schneller, aber weniger kompatibel. Bei Neuinstallationen ist WSL 2 die Standardversion und für die meisten Nutzer die richtige Wahl.

02Voraussetzungen

WSL ist ein reines Windows-Feature; Nutzer von macOS und Linux brauchen es nicht, da dort bereits ein Unix-basiertes Terminal vorhanden ist. Unter Windows sind einige Voraussetzungen nötig.

• Windows 11 oder Windows 10 ab Version 2004 (Build 19041); Ihre Version sehen Sie mit dem Befehl winver.
• In den BIOS/UEFI-Einstellungen muss die Virtualisierung (Intel VT-x oder AMD-V/SVM) aktiviert sein. Prüfen Sie im Task-Manager auf dem Reiter Leistung unter CPU den Eintrag Virtualisierung: Aktiviert.
• Ein Benutzerkonto mit Administratorrechten.
• Einige GB freier Speicherplatz für Distribution und Tools.

03WSL 2 mit einem einzigen Befehl installieren

Klicken Sie im Startmenü mit der rechten Maustaste auf PowerShell und wählen Sie Als Administrator ausführen. Der folgende Befehl aktiviert die Funktionen WSL und Plattform für virtuelle Computer, lädt den Linux-Kernel herunter und installiert Ubuntu.

1. Starten Sie den Computer nach der Installation neu.
2. Beim Start öffnet sich das Ubuntu-Fenster von selbst und entpackt die Dateien; das kann einige Minuten dauern.
3. Legen Sie einen Linux-Benutzernamen und ein Passwort fest. Dieses Konto ist unabhängig von Ihrem Windows-Konto; bei sudo-Befehlen wird dieses Passwort abgefragt.
4. Aktualisieren Sie die Paketliste und führen Sie ein System-Upgrade durch.

wsl --install

Erstes Update und Überprüfung

Aktualisieren Sie die Pakete im Ubuntu-Terminal und lassen Sie sich anschließend in PowerShell die installierten Distributionen samt Version auflisten. Steht in der Spalte VERSION eine 2, läuft WSL 2.

sudo apt update && sudo apt upgrade -y

wsl -l -v
wsl --status

04Distribution wählen und verwalten

Standardmäßig wird Ubuntu installiert, doch auch Debian, openSUSE und andere Distributionen lassen sich einrichten. Ubuntu unter Windows ist für den Anfang am bequemsten, weil es zu den meisten Tutorials und Dokumentationen eins zu eins passt.

• wsl --list --online listet die installierbaren Distributionen auf.
• wsl --set-version überführt eine mit WSL 1 installierte Distribution auf WSL 2.
• wsl --shutdown beendet alle Distributionen und die WSL-VM; nach Änderungen an den Einstellungen ist das nötig.
• Zum Sichern einer Distribution dient wsl --export, zum Wiederherstellen wsl --import.

wsl --list --online
wsl --install -d Debian
wsl --set-default Ubuntu
wsl --set-default-version 2
wsl --set-version Ubuntu 2
wsl --update
wsl --shutdown

05Wo sollten Ihre Dateien liegen?

In WSL leben zwei Dateisysteme nebeneinander. Windows-Laufwerke erscheinen in Linux unter Pfaden wie /mnt/c; Linux-Dateien öffnen Sie im Windows-Explorer unter der Adresse \\wsl.localhost\Ubuntu. Für den schnellen Zugriff im Explorer können Sie im Ubuntu-Terminal explorer.exe . eingeben.

Die goldene Regel lautet: Halten Sie Projektdateien im Linux-Dateisystem (zum Beispiel /home/benutzer/projekte). Befehle wie npm install, git status oder Build-Vorgänge unter /mnt/c laufen wegen der Übersetzung zwischen den beiden Systemen spürbar langsamer, und die Dateiüberwachung (Hot Reload) funktioniert mitunter gar nicht. Die Geschwindigkeit der Entwicklungsumgebung wirkt sich auf die Teameffizienz ebenso aus wie Maßnahmen auf der Live-Seite, etwa eine Speed- und Performance-Optimierung.

06VS Code, Git und Docker anbinden

Die eigentliche Stärke von WSL liegt im Zusammenspiel mit den Tools unter Windows. Der Code-Editor öffnet sich in Windows, doch Befehle, Erweiterungen und Terminal laufen innerhalb von Linux.

VS Code

Installieren Sie in VS Code die WSL-Erweiterung von Microsoft. Wechseln Sie im Ubuntu-Terminal in den Projektordner und geben Sie code . ein; der Editor öffnet sich im WSL-Modus, unten links erscheint die Verbindungsanzeige.

Git

Konfigurieren Sie Git innerhalb von Linux separat; die Git-Einstellungen von Windows werden nicht in WSL übernommen. Details finden Sie in unserer Anleitung zur Git-Installation.

sudo apt install git -y
git config --global user.name 'Ad Soyad'
git config --global user.email ad@ornek.com
git config --global core.autocrlf input

Docker

Docker Desktop nutzt in den Einstellungen die WSL-2-basierte Engine und lässt sich in die gewählten Distributionen integrieren; so führen Sie docker-Befehle direkt im Ubuntu-Terminal aus. Die Schritte stehen im Beitrag Docker installieren. Möchten Sie die Datenbank statt in einem Container direkt in Ubuntu installieren, funktionieren die Linux-Schritte aus der Anleitung PostgreSQL installieren in WSL unverändert.

07Ein typischer Entwicklungsablauf mit WSL

Nach der Installation pendelt sich die tägliche Arbeit in wenigen Schritten ein. Sie öffnen das Ubuntu-Terminal, wechseln in den Projektordner im Home-Verzeichnis und starten den Editor mit code . Node.js installieren Sie mit nvm, Python mit venv, die Datenbank mit apt oder Docker; alles läuft mit denselben Befehlen wie in der Linux-Umgebung auf dem Livesystem.

Besonders bei Projekten, in denen mehrere Systeme miteinander kommunizieren, macht dieses Vorgehen den Unterschied. Wenn Sie etwa Integrationen, die den Shop mit Lager-, Versand- und Buchhaltungsdiensten verbinden, lokal unter Linux testen, gibt es beim Livegang weniger Überraschungen. Auch Branchensoftware etwa für Reservierungen oder Inserate läuft meist auf Linux-Servern und wird deshalb in derselben Umgebung entwickelt und getestet.

Arbeiten Sie im Team, vermeidet es »Bei mir läuft es aber«-Probleme, wenn alle dieselbe Distribution und dieselben Tool-Versionen verwenden. Wer die Installationsschritte in einer README-Datei oder einem Setup-Skript festhält, richtet neuen Kollegen die Umgebung in wenigen Minuten ein.

08Arbeitsspeicher und Ressourcen konfigurieren

WSL 2 belegt Arbeitsspeicher nach Bedarf und kann Windows bei langen Sitzungen ausbremsen. Um Grenzen zu setzen, legen Sie in Ihrem Windows-Benutzerordner (C:\Users\benutzer) die Datei .wslconfig an. Starten Sie WSL nach der Änderung mit wsl --shutdown neu.

[wsl2]
memory=4GB
processors=2

09Häufige Fehler und Lösungen

Die meisten Installationsfehler bei WSL entstehen durch deaktivierte Virtualisierung oder fehlende Windows-Komponenten. Notieren Sie den Fehlercode und vergleichen Sie ihn mit der folgenden Tabelle.

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart