WSL: Linux unter Windows

Möchten Sie Linux-Tools (Docker, Python, Node.js) nutzen, ohne Windows zu verlassen? Dann ist WSL (Windows Subsystem for Linux) die Lösung. Es ist ein vollwertiger Linux-Kernel, der parallel zu Ihrem Hauptsystem läuft.

Bevor Sie beginnen, prüfen Sie Ihr BIOS. Die Virtualisierung (VT-x oder AMD-V) muss aktiviert sein. Ohne diese Einstellung lässt sich Linux nicht starten.

Hier erfahren Sie, wie Sie beide Systeme für eine reibungslose Zusammenarbeit einrichten.

1. Status überprüfen

Prüfen Sie vor dem Start den aktuellen Systemzustand in der PowerShell:

wsl -l -v

wsl -l -v gibt eine Liste der installierten Distributionen zurück:

Leere Antwort: Keine Distributionen installiert.
Ubuntu: Linux ist bereits installiert.
docker-desktop / docker-desktop-data: Technische Distributionen für Docker Desktop.

⚠️ In der Spalte VERSION sollte eine 2 stehen. Falls dort eine 1 steht, aktualisieren Sie die Distribution mit dem Befehl wsl --set-version Ubuntu 2.

2. Installation

Falls Linux noch nicht installiert ist, öffnen Sie die PowerShell als Administrator und geben Sie ein:

wsl --install

Das System bereitet Ubuntu vor. Nach Abschluss müssen Sie den Computer neu starten, um die Kernel-Konfiguration abzuschließen.

3. Benutzereinrichtung

Beim ersten Start fordert WSL Sie auf, einen Benutzer zu erstellen. Wenn Sie im Terminal root@PC_NAME sehen, ist das normal.

Root wird für Systemeinstellungen benötigt; erstellen Sie für die Entwicklung einen separaten Benutzer.

Hinweis ⚠️: Das Tilde-Symbol ~ steht für das Home-Verzeichnis. Bei root ist dies /root, bei einem normalen Benutzer /home/ihr_benutzername. Wenn Sie Projekte unter root erstellen, kommt es zu Berechtigungsproblemen in VS Code. Der Befehl cd ~/projects führt bei root und einem normalen Benutzer an unterschiedliche Orte.

So erstellen Sie einen Benutzer:

# Benutzer ihr_benutzername erstellen
adduser ihr_benutzername
# Administratorrechte vergeben (für sudo)
usermod -aG sudo ihr_benutzername

Damit WSL immer mit Ihrem Benutzernamen öffnet, geben Sie dies in der Windows PowerShell ein:

# Ersetzen Sie ihr_benutzername durch Ihren tatsächlichen Namen
ubuntu config --default-user ihr_benutzername

Das Terminal begrüßt Sie nun mit: ihr_benutzername@PC_NAME:~$.

4. Speicherort für Code

WSL hat Zugriff auf Windows-Laufwerke (/mnt/c/), aber speichern Sie Ihre Projekte nicht dort.

Die Dateisysteme von Windows und Linux kommunizieren langsam miteinander. Projekte auf Laufwerk C: oder D: verlangsamen die Arbeit mit dem Code erheblich.

Der richtige Ort: Ihr Linux-Home-Ordner.
Geben Sie ein:

cd ~
mkdir projects && cd projects

Hier ist die Geschwindigkeit maximal. Um den Ordner im Windows-Explorer zu öffnen: explorer.exe .

5. Tech-Stack

Python (venv)

Isolieren Sie Pakete unter Linux. Installieren Sie Bibliotheken nicht global, sondern nutzen Sie virtuelle Umgebungen:

sudo apt update && sudo apt upgrade -y
sudo apt install python3-pip python3-venv -y

# Projekt-Setup
mkdir mein_projekt && cd mein_projekt
python3 -m venv venv
source venv/bin/activate

Node.js (NVM)

Das Standard-apt install nodejs installiert oft eine veraltete Version. Nutzen Sie NVM (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts    # Installiert die aktuellste stabile Version

6. Integration

VS Code

Installieren Sie VS Code unter Windows und die Erweiterung Remote – WSL. Wenn Sie code . im Ubuntu-Terminal eingeben, öffnet sich das Projekt in der Windows-Oberfläche, während der Code innerhalb von Linux ausgeführt wird.

Docker

Aktivieren Sie in den Docker Desktop-Einstellungen (Settings -> Resources -> WSL Integration) das Häkchen bei Ubuntu. Jetzt können Sie Container direkt über das Linux-Terminal steuern.

7. Daily Cheat Sheet

whoami — Prüfen, ob Sie root oder ein normaler Benutzer sind.
pwd — Vollständiger Pfad zum aktuellen Ordner.
wsl --shutdown — (In PowerShell) Linux komplett stoppen, um RAM freizugeben.
cat datei.txt | clip.exe — Text von Linux in die Windows-Zwischenablage kopieren.

Workflow:

Terminal öffnen (ihr_benutzername@...).
In das Projekt wechseln (cd ~/projects/meine-app).
VS Code starten (code .).
Profit.