Docker unter WSL 2: Der Game-Changer für Webentwickler

Dieser Artikel ist Teil unserer Serie zur modernen WSL 2 Webentwicklung.

Die Arbeit mit Docker unter WSL 2 war lange Zeit ein Traum, der nun Realität ist. Früher war Docker auf Windows ein Kompromiss: schwere VirtualBox-VMs, träges Hyper-V, hoher Ressourcenverbrauch und ständige Netzwerkprobleme.

Mit der Einführung von Docker unter WSL 2 hat sich das grundlegend geändert. Die Container laufen heute auf einem echten Linux-Kernel, tief integriert in Windows – ohne Emulation, ohne Übersetzungsschichten. In diesem siebten Teil der Serie zeige ich dir im Detail, wie du Docker unter WSL 2 sauber, performant und alltagstauglich einsetzt. Wir gehen alle Szenarien durch: Vom einfachen Webserver über PHP-Stacks bis hin zur Laravel-Installation.

Warum WSL 2 der technische Game-Changer ist

Um zu verstehen, warum dein Setup plötzlich so schnell ist, lohnt ein Blick unter die Haube. Der entscheidende Unterschied liegt im Kernel.

In der alten Welt (WSL 1) mussten Systemaufrufe (Syscalls) mühsam von Linux nach Windows übersetzt werden. Das war bei Dateioperationen extrem langsam und führte oft zu Fehlern bei komplexen Tools.

In der neuen Welt (WSL 2) läuft eine echte Linux-Utility-VM mit eigenem Kernel. Das bringt dir drei massive Vorteile:

1. Native Docker-Performance: Container starten in Sekundenbruchteilen.

2. Volle Kompatibilität: Du kannst exakt dieselben Linux-Images nutzen wie in der Produktion.

3. Hybrider Workflow: Docker-Befehle funktionieren gleichzeitig in der Windows PowerShell und im WSL 2 Terminal (Ubuntu).

Docker ist kein Fremdkörper mehr, sondern Teil des Systems.

Setup: Docker Desktop mit WSL 2 Backend

Bevor wir Code schreiben, müssen wir das Fundament legen.

1. Voraussetzungen prüfen

Du benötigst Windows 10 (ab Build 18362) oder Windows 11. Öffne deine PowerShell und prüfe, ob WSL 2 als Standard gesetzt ist:

wsl --set-default-version 2

2. Docker Desktop korrekt konfigurieren

Lade Docker Desktop für Windows herunter und installiere es. Achte während der Installation (oder nachträglich in den Einstellungen) auf diesen entscheidenden Haken:

Use the WSL 2 based engine

Damit verhindern wir, dass Docker die alte, schwere Hyper-V VM nutzt.

3. Die Brücke zu Ubuntu schlagen (Wichtig!)

Das ist der Schritt, den viele vergessen: Docker läuft zwar, aber dein Ubuntu-Terminal weiß noch nichts davon.

1. Öffne Docker Desktop → Settings (Zahnrad).

2. Gehe zu Resources → WSL Integration.

3. Aktiviere den Schalter bei deiner Distribution (z. B. Ubuntu-24.04).

4. Klicke auf Apply & Restart.

Prüfe nun in deinem WSL-Terminal, ob die Verbindung steht:

docker --version
docker ps

Erscheint hier keine Fehlermeldung, bist du bereit.

Praxis-Teil 1: Die Basics (Nginx & Apache)

Jetzt gehen wir in die Praxis. Welchen Webserver du wählst, ist Geschmackssache – Docker kann beides.

Option A: Der Nginx-Test (Hello World)

Perfekt für statische Seiten oder als Reverse Proxy.

docker run -d -p 8080:80 --name mein-webserver nginx

Öffne jetzt deinen Windows-Browser: http://localhost:8080 Du siehst die "Welcome to nginx"-Seite.

Warum das genial ist: WSL 2 leitet den Port automatisch an Windows weiter. Du musst keine IP-Adresse der VM suchen. Es fühlt sich an wie localhost.

Option B: Der Apache Quickstart

Viele PHP-Entwickler bevorzugen Apache wegen der .htaccess Unterstützung.

docker run -d -p 8081:80 --name mein-apache apache

(Hinweis: Wir nutzen hier Port 8081, falls 8080 noch vom Nginx belegt ist). Unter http://localhost:8081 begrüßt dich nun: It works!

Praxis-Teil 2: Echten Code einbinden (PHP & Mounts)

Ein leerer Server nützt uns nichts. Wir wollen unseren Code live bearbeiten. Dazu nutzen wir "Bind Mounts".

Apache mit eigenem Projekt verbinden

Vorbereitung: Erstelle einen Ordner in deinem WSL-Home (nicht auf /mnt/c!):

mkdir -p ~/projects/apache-test
cd ~/projects/apache-test
echo "<div>Mein Code lebt!</div>" > index.html

Der Start-Befehl:

docker run -d \
  -p 8082:80 \
  -v $(pwd):/usr/local/apache2/htdocs \
  --name apache-dev \
  httpd:2.4

Erklärung:

• -v $(pwd):/usr/local/apache2/htdocs: Wir spiegeln das aktuelle Verzeichnis (pwd) direkt in das Dokumenten-Verzeichnis des Containers.

• Änderst du nun die index.html in VS Code, ist die Änderung sofort im Browser sichtbar.

Apache mit PHP (Der realistische Stack)

Apache allein kann kein PHP parsen. Dafür nutzen wir ein Image, das PHP bereits integriert hat.

Vorbereitung:

echo "<?php phpinfo();" > index.php

Der Container-Start:

docker run -d \
  -p 8083:80 \
  -v $(pwd):/var/www/html \
  --name apache-php \
  php:8.3-apache

Rufe http://localhost:8083 auf. Du siehst die volle PHP-Info-Tabelle. Das ist ein vollwertiger LAMP-Stack (ohne MySQL), hochgefahren in 2 Sekunden.

Praxis-Teil 3: Laravel in Docker installieren (Advanced)

Kommen wir zur Königsdisziplin. Du willst Laravel nutzen, hast aber keine Lust, PHP und Composer lokal zu installieren? Kein Problem. Wir nutzen Docker, um Laravel zu installieren und auszuführen.

Wir nutzen dazu Laravel Sail, eine leichte Docker-Umgebung, die standardmäßig mit Laravel kommt.

Schritt 1: Das Projekt erstellen

Wir nutzen einen temporären Container, der uns curl und php zur Verfügung stellt, um den Installer zu laden.

Führe diesen Befehl in deinem ~/projects Ordner aus:

curl -s "https://laravel.build/mein-laravel-app" | bash

Was passiert hier?

1. Der Befehl lädt ein Docker-Script von Laravel.

2. Er startet einen Container, der PHP und Composer enthält.

3. Er installiert ein komplettes Laravel-Projekt in den Ordner mein-laravel-app.

4. Das alles passiert, ohne dass du PHP lokal installiert haben musst.

Schritt 2: Den Stack starten

Wechsle in das neue Verzeichnis und starte die Umgebung:

cd mein-laravel-app
./vendor/bin/sail up -d

(Hinweis: "Sail" ist ein Wrapper um docker-compose. Es startet PHP, MySQL, Redis und Mailpit automatisch).

Schritt 3: Entwickeln

Öffne http://localhost in deinem Browser. Du siehst die Laravel-Startseite.

Um Befehle auszuführen (z. B. Migrationen), nutzt du einfach Sail:

./vendor/bin/sail artisan migrate

So hast du eine komplette Enterprise-Entwicklungsumgebung aufgesetzt, ohne dein Windows-System mit Installationen zuzumüllen. Das ist die Power von Docker unter WSL 2.

Aufräumen: Sauberkeit muss sein

Container sind keine Haustiere, sondern Nutzvieh. Wenn du fertig bist, lösche sie.

Einzeln stoppen und löschen:

docker stop apache-dev
docker rm apache-dev

Oder alle Test-Container aus diesem Tutorial auf einmal entfernen:

docker rm -f mein-webserver mein-apache apache-dev apache-php

(Um Laravel Sail zu stoppen, gehe in den Ordner und tippe ./vendor/bin/sail down).

Typische Fehler unter WSL 2 (Troubleshooting)

Auch mit Docker unter WSL 2 gibt es Stolpersteine. Hier sind die Klassiker:

1. Port 80 ist blockiert Du startest einen Container auf Port 80, aber er bricht ab? Ursache: Unter Windows läuft oft der IIS (Internet Information Services) oder Skype, die diesen Port blockieren. Lösung: Nutze immer alternative Ports wie 8080, 8081 etc. (-p 8080:80).

2. Extrem langsame Performance Der Container läuft, aber das Laden der Seite dauert 2-3 Sekunden? Ursache: Dein Projekt liegt unter /mnt/c/Users/.... Docker muss jede Datei über das langsame 9P-Protokoll von Windows holen. Lösung: Verschiebe dein Projekt nach ~/projects/mein-projekt. (Siehe Teil 6 der Serie).

3. Docker Befehl nicht gefunden Ursache: Du hast ein neues Terminal-Fenster geöffnet, bevor du die WSL-Integration in Docker Desktop aktiviert hast. Lösung: Integration aktivieren (siehe oben) und Terminal neu starten.

Können deine Container keine Pakete laden? In Firmennetzwerken blockieren oft Proxies oder VPNs. Hier findest du den Fix für WSL 2 im Unternehmensnetzwerk.

Der vmmem-Faktor: Speicher im Griff behalten

Docker unter WSL 2 liebt RAM. Im Taskmanager wirst du den Prozess vmmem sehen. Er reserviert Speicher für die Linux-VM und den Cache.

Wenn dein System träge wird, begrenze den RAM in deiner .wslconfig Datei (unter C:\Users\DeinName\.wslconfig):

[wsl2]
memory=8GB

(Mehr dazu im kommenden Teil 8).

Zusätzlich solltest du regelmäßig aufräumen:

docker system prune

Fazit: Die Analogie zur Einordnung

Stell dir Docker unter WSL 2 wie eine professionelle Großküche (Linux) vor, die direkt an deinen Gastraum (Windows) angebaut wurde. Die Küche arbeitet effizient, laut und mit scharfen Messern. Du sitzt aber bequem im Gastraum, nutzt deine gewohnten Werkzeuge und bekommst das Ergebnis über die Durchreiche (Localhost) serviert.

Du musst den Maschinenraum nicht betreten, um die Power zu nutzen.