WSL2 & Docker Desktop & DDEV: Installation

1.1 Voraussetzungen

Empfohlen sind mindestens etwa 8 GB RAM und genügend freier Speicherplatz. Für Windows ist WSL2 die Grundlage unserer Entwicklungsumgebung. DDEV Docs

Wir verwenden:

Windows 11
   │
   ├── Docker Desktop
   │
   └── WSL2
        └── Ubuntu
             └── DDEV
                  └── Contao 5.7

1.2 WSL2 installieren

Windows PowerShell als Administrator öffnen.

wsl --install --no-distribution

Danach:

wsl --update

Falls Windows einen Neustart verlangt, PC neu starten.

Nun Ubuntu für DDEV installieren:

wsl --install Ubuntu-26.04 --name DDEV

Beim ersten Start wird nach einem Linux-Benutzernamen und Passwort gefragt.

Beispiel:

Benutzer: fast
Passwort: ********

Das Passwort wird später bei sudo benötigt.

DDEV dokumentiert genau diesen WSL2-Aufbau und empfiehlt Ubuntu als Distribution. DDEV Docs

1.3 WSL prüfen

In PowerShell:

wsl -l -v

Es sollte ungefähr erscheinen:

NAME    STATE     VERSION
DDEV    Running   2

Wichtig ist:

VERSION 2

1.4 Docker Desktop installieren

Docker Desktop herunterladen

Docker Desktop installieren und darauf achten, dass der WSL-2-Backend verwendet wird.

Danach Docker Desktop starten.

Unter:

Settings
→ Resources
→ WSL Integration

die Distribution

DDEV

aktivieren. DDEV beschreibt Docker Desktop mit WSL2 als unterstützte Windows-Konfiguration. DDEV Docs

1.5 Docker testen

Jetzt nicht mehr in PowerShell arbeiten, sondern die DDEV/Ubuntu-Konsole öffnen.

Dort:

docker ps

Wenn Docker funktioniert, erscheint eine Tabelle ähnlich:

CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS   NAMES

Es müssen noch keine Container vorhanden sein.

1.6 DDEV installieren

DDEV kann unter Windows inzwischen komfortabel über den offiziellen Installer installiert werden. Eine Möglichkeit ist in PowerShell:

winget install --interactive DDEV

Bei unserer Konfiguration wählen wir die Variante für:

WSL2
Docker Desktop
DDEV Distribution

Die aktuelle offizielle Windows-Anleitung findest du hier:

DDEV – Installation unter Windows

Anschließend wieder die DDEV/Ubuntu-Konsole öffnen und testen:

ddev version

Es sollte die installierte DDEV-Version angezeigt werden.