Installieren Sie Docker unter Windows mit WSL 2 und führen Sie Ihren ersten Container aus
Docker unter Windows funktioniert am besten auf einem echten Linux-Kernel, und WSL 2 bietet Ihnen genau das. In diesem Leitfaden werden die Dinge in der Reihenfolge installiert, die die klassischen Fehler vermeidet – zuerst WSL 2, dann Docker Desktop und ein kleiner Testcontainer, um zu beweisen, dass die gesamte Kette funktioniert.
✍️ Technical Anshu🪟 Windows 10 / 11⏱️ 10 minute setup and read
🎥 Sehen Sie sich die vollständige Installation im Video an – WSL 2-Setup und der erste Container, Schritt für Schritt
Die meisten fehlgeschlagenen Docker-Installationen unter Windows scheitern aus einem langweiligen Grund: Die Reihenfolge war falsch. Docker Desktop erwartet darunter ein funktionierendes WSL 2, daher bauen wir zunächst das Fundament, prüfen es und installieren erst dann Docker. Am Ende führen Sie hello-world aus – einen winzigen Container, der beweist, dass der Client, die Engine, das Netzwerk und der Bildspeicher funktionieren. Folgen Sie dem Video oben für die Anleitung auf dem Bildschirm. Diese Seite ist die schriftliche Checkliste mit den ehrlichen Warnungen.
Windows PowerShell - the two commands that prove the install (real output style)
PS C:\Users\Anshu> docker --version
Docker version 27.x, build xxxxxxx
PS C:\Users\Anshu> docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
Hello from Docker!
This message shows that your installation appears
to be working correctly.
Wie Erfolg tatsächlich aussieht – die Versionszeile, der erste Pull und Dockers eigene Bestätigungsnachricht
1
Überprüfen Sie zunächst, ob Ihr PC dies kann
Docker Desktop mit dem WSL 2-Backend benötigt drei Dinge. Wer diesen Scheck auslässt, verliert einen Abend.
Windows 10 Version 2004 oder höher oder Windows 11 – prüfen Sie mit winver
Virtualisierung im BIOS oder UEFI aktiviert – ö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 zunächst Intel VT-x oder AMD SVM im BIOS
Etwa 4 GB freier RAM und ein paar GB Festplatte – WSL 2 und Docker teilen sich Ihren Computer, sie ersetzen ihn nicht
Ehrlicher Hinweis: Bei Windows Home-Editionen ist diese WSL 2-Route kein Workaround, sondern die beabsichtigte Route. Hyper-V ist dafür nicht erforderlich.
2
Installieren Sie WSL 2 vor allem anderen
Öffnen Sie PowerShell als Administrator und führen Sie einen Befehl aus:
wsl --install
Lassen Sie es ablaufen und starten Sie dann den PC neu – dieser Schritt ist nicht optional, der Neustart 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. Dieses Passwort gilt nur für Linux sudo – wählen Sie eines aus, das Sie sich merken können, da während der Eingabe nichts auf dem Bildschirm angezeigt wird
Bestätigen Sie die Grundlage mit wsl --status und wsl -l -v – Ihre Distribution sollte VERSION 2 anzeigen. Wenn 1 angezeigt wird, führen Sie wsl --set-default-version 2 aus und konvertieren Sie die Distribution, wie in der Befehlsausgabe vorgeschlagen
In diesem Set gibt es eine ganze Seite darüber, warum diese Reihenfolge wichtig ist und was kaputt geht, wenn Docker zuerst einsteigt.
3
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 sie 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
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, und auf der Lizenzseite in diesem Satz wird erläutert, wann Docker Desktop kostenlos ist und wann ein Unternehmen zahlen muss
4
Beweisen Sie es mit Hello World
Öffnen Sie ein neues PowerShell- oder Terminalfenster und führen Sie Folgendes aus:
docker --version – beweist, dass der Client installiert ist und sich auf 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 druckt seine Nachricht
Wenn die Meldung angezeigt wird, funktioniert Ihre Kette durchgehend: Terminal, Client, Engine in WSL 2, Netzwerk und Registrierung
Ehrlich gesagt: Der erste Lauf benötigt das Internet für den Pull. Wenn dies fehlschlägt, führen Sie nicht blind eine Neuinstallation durch. Die nicht startende Ladder-Seite in diesem Set geht die Ursachen der Reihe nach durch.
5
Zwei ehrliche Warnungen, bevor Sie fortfahren
docker-users bedeutet Macht. Jeder in dieser Gruppe kann Container ausführen, und ein Container kann das gesamte Windows-Laufwerk bereitstellen. Behandeln Sie die Mitgliedschaft von docker-users als Vertrauensstellung auf Administratorebene und fügen Sie nur Konten hinzu, denen Sie die Maschine übergeben würden.
Behalten Sie Projektdateien in Linux. Im WSL-Dateisystem (Ihrem Ubuntu-Home-Ordner) gespeicherter Code ist für Container wesentlich schneller als die gleichen Dateien, die über /mnt/c erreicht werden. Verschieben Sie aktive Projekte nach Linux und öffnen Sie sie von dort aus.
🔴 Docker Desktop ist für den persönlichen Gebrauch und kleine Unternehmen im Rahmen der von Docker veröffentlichten Größengrenzen kostenlos – und ein kostenpflichtiges Abonnement pro Benutzer für größere Unternehmen. Wenn Sie dies auf einem Bürocomputer installieren, lesen Sie die Lizenzierungsseite in diesem Set, bevor Ihr IT- oder Prüfungsteam die Frage zuerst stellt.
🎥 Sehen Sie sich den kompletten Vorgang im Video an
Sehen Sie sich das vollständige Setup im Video an – WSL 2-Installation, Docker Desktop-Installation und der erste Container, der live läuft.
Für den persönlichen Gebrauch, Bildungseinrichtungen und kleine Unternehmen im Rahmen der von Docker veröffentlichten Mitarbeiter- und Umsatzgrenzen ist Docker Desktop kostenlos. Größere Unternehmen benötigen ein kostenpflichtiges Abonnement pro Benutzer. Docker Engine auf einem Linux-Server ist eine separate Open-Source-Route und wird auf der Lizenzierungsseite dieses Sets behandelt.
Benötige ich Windows 11 Pro oder Hyper-V für Docker mit WSL 2?
Nein. Das WSL 2-Backend funktioniert auch unter Windows 10 Home und Windows 11 Home. Sie benötigen eine im BIOS aktivierte Virtualisierung und einen ausreichend aktuellen Windows-Build. Hyper-V wird nur für das ältere Hyper-V-Backend benötigt, das in diesem Handbuch nicht verwendet wird.
Docker Desktop bleibt beim Starten hängen. Was sollte ich zuerst prüfen?
Überprüfen Sie in dieser Reihenfolge: Virtualisierung wird im Task-Manager als „Aktiviert“ angezeigt, wsl --status läuft sauber und Ihre Distribution ist Version 2, der Docker-Desktop-Dienst wird in „services.msc“ ausgeführt und Sie haben sich seit der Installation ab- und wieder angemeldet, sodass die Gruppe „docker-users“ gilt. Die Fix-Leiterseite in diesem Set durchläuft jeden Schritt.
Diese Anleitung basiert auf dem Technical Anshu Docker on WSL 2-Video • Sind Sie bei irgendeinem Schritt stecken geblieben? Fragen Sie in den Videokommentaren nach – dort erhalten Sie eine Antwort 🙏