Docker-Installation auf WSL 2 – Erstes Container-Setup

Überprüfen Sie zuerst Ihren PC

Docker Desktop mit dem WSL 2-Backend benötigt drei Dinge, und wenn man diesen zweiminütigen Check überspringt, verliert man einen Abend. Zuerst die Windows-Version: Sie benötigen Windows 10 Version 2004 oder höher oder Windows 11. Drücken Sie Win + R, geben Sie winver ein und drücken Sie die Eingabetaste, um Ihre genaue Version anzuzeigen.

winver

Zweitens muss die Virtualisierung im BIOS oder UEFI eingeschaltet sein. Öffnen Sie den Task-Manager, gehen Sie zu Leistung, dann zu CPU und suchen Sie nach Virtualisierung: Aktiviert. Wenn „Deaktiviert“ angezeigt wird, werden Sie durch keine Softwareeinstellung gerettet – aktivieren Sie zuerst Intel VT-x oder AMD SVM im BIOS. Drittens: Halten Sie etwa 4 GB freien RAM und ein paar GB freien Speicherplatz bereit: WSL 2 und Docker teilen sich Ihren Computer, sie ersetzen ihn nicht.

Installieren Sie WSL 2 vor allem anderen

Die meisten fehlgeschlagenen Docker-Installationen unter Windows scheitern aus einem langweiligen Grund: Die Reihenfolge war falsch. Docker Desktop erwartet eine funktionierende WSL 2 darunter, also bauen Sie zuerst das Fundament. Öffnen Sie PowerShell als Administrator und führen Sie einen Befehl aus:

wsl --install

Lassen Sie den Vorgang abschließen und starten Sie dann den PC neu. Der Neustart ist nicht optional, er lädt die Virtualisierungskomponenten. Nach dem Neustart schließt Ubuntu (die Standarddistribution) sein eigenes Setup ab und fordert Sie auf, einen Linux-Benutzernamen und ein Linux-Passwort zu erstellen.

Stellen Sie sicher, dass WSL 2 wirklich bereit ist

Bevor Docker sich der Maschine nähert, bestätigen Sie das Fundament mit zwei Befehlen:

wsl --status
wsl -l -v

Ihre Distribution sollte VERSION 2 in der Liste anzeigen. Wenn 1 angezeigt wird, legen Sie die Standardversion fest und konvertieren Sie die Distribution, wie in der Befehlsausgabe vorgeschlagen:

wsl --set-default-version 2

Jede Schicht wird getestet, bevor die nächste weitergeht. Wenn also später etwas ausfällt, wissen Sie genau, welche Schicht das Problem verursacht.

Installieren Sie Docker Desktop oben

Laden Sie Docker Desktop nur von docker.com herunter – Download-Sites von Drittanbietern bündeln Müll mit beliebten Installationsprogrammen. Führen Sie das Installationsprogramm aus und lassen Sie die Option WSL 2 anstelle von Hyper-V verwenden aktiviert. Auf den meisten PCs ist es standardmäßig aktiviert.

Wenn das Installationsprogramm Sie dazu auffordert, schließen Sie es und melden Sie sich ab oder starten Sie es neu, wenn Sie dazu aufgefordert werden. Docker fügt Ihr Windows-Konto der lokalen Gruppe docker-users hinzu, und die Gruppenmitgliedschaft wird erst bei einer erneuten Anmeldung wirksam – dies ist die ehrliche Prüfung, die die meisten Anleitungen überspringen, und aus diesem Grund weigert sich Docker manchmal, zu starten, bis Sie sich ab- und wieder anmelden.

Starten Sie Docker Desktop und warten Sie, bis sich das Walsymbol in der Taskleiste stabilisiert und das Dashboard Engine läuft meldet. Der erste Start ist langsam; gib ihm ein paar Minuten. Akzeptieren Sie den Bildschirm „Docker Subscription Service Agreement“ ehrlich – es handelt sich um eine echte Lizenz.

Führen Sie Ihren ersten Container aus – Hello World

Öffnen Sie ein neues PowerShell- oder Terminalfenster und führen Sie die beiden Befehle aus, die beweisen, dass die gesamte Kette funktioniert:

docker --version
docker run hello-world

docker --version beweist, dass der Client installiert ist und sich in Ihrem PATH befindet. docker run hello-world beweist alles andere: Docker kann das Image nicht lokal finden, lädt es vom Docker Hub herunter, erstellt daraus einen Container, führt es aus und gibt seine Hello from Docker!-Nachricht aus. Wenn diese Meldung angezeigt wird, funktioniert Ihre Kette durchgehend – Terminal, Client, Engine in WSL 2, Netzwerk und Registrierung.