Schritt-für-Schritt-Anleitung: Installation von Docker Desktop unter Windows und macOS

Docker Desktop ist der übliche Ausgangspunkt, wenn Sie Container auf einem Windows- oder macOS-Laptop ausführen möchten. Die Installation ist einfach, aber einige Systemeinstellungen können verhindern, dass Docker nach Abschluss des Installationsprogramms startet.

Diese Anleitung führt Sie durch die Installation von Docker Desktop unter Windows und macOS und überprüft anschließend, ob die Docker CLI, die Docker Engine und ein Testcontainer korrekt funktionieren.

Was Docker Desktop installiert

Docker Desktop bietet Ihnen eine lokale Docker-Umgebung mit der Docker CLI, der Docker Engine, Docker Compose, einem Desktop-Dashboard und optionaler Kubernetes-Unterstützung. Unter Windows führt Docker Desktop normalerweise Linux-Container über WSL 2 aus. Unter macOS werden Container in einer leichten Linux-VM ausgeführt.

Für die tägliche Entwicklung bedeutet dies, dass Sie Befehle wie die folgenden ausführen können:

docker run hello-world
docker compose up
docker build -t my-app .

Sie müssen kein separates Docker Engine-Paket zuerst installieren.

Überprüfen Sie zuerst die Anforderungen

Docker ändert im Laufe der Zeit die Plattformanforderungen. Überprüfen Sie daher die aktuelle Docker-Dokumentation, bevor Sie auf älteren Maschinen installieren. Bei den meisten aktuellen Setups sollten Sie diese Grundlagen bestätigen.

Windows-Anforderungen

Verwenden Sie eine unterstützte 64-Bit-Windows-Edition und halten Sie Windows auf dem neuesten Stand. Docker Desktop funktioniert am besten mit dem WSL 2-Backend. Installieren Sie WSL daher vor oder während der Einrichtung:

wsl --install

Führen Sie diesen Befehl in einer erhöhten PowerShell- oder Eingabeaufforderung aus und starten Sie dann neu, wenn Windows Sie dazu auffordert.

Überprüfen Sie auch die Hardware-Virtualisierung. Öffnen Sie den Task-Manager, gehen Sie zu Leistung, wählen Sie CPU und suchen Sie nach Virtualisierung: Aktiviert. Wenn sie deaktiviert ist, aktivieren Sie sie in Ihren BIOS- oder UEFI-Einstellungen.

Docker Desktop ist für Desktop-Windows-Umgebungen gedacht, nicht für Windows Server.

macOS-Anforderungen

Verwenden Sie eine unterstützte macOS-Version auf einem Apple Silicon- oder Intel-Mac. Laden Sie das richtige Installationsprogramm für Ihren Chiptyp herunter. Wenn Sie nicht sicher sind, welchen Mac Sie haben, öffnen Sie Apple-Menü > Über diesen Mac und überprüfen Sie die Chip- oder Prozessorzeile.

Docker Desktop benötigt genügend Arbeitsspeicher und Festplattenspeicher, um eine Linux-VM auszuführen und Images zu speichern. Wenn Sie planen, Datenbanken oder Multi-Service-Stacks lokal auszuführen, geben Sie Docker nach der Installation in den Einstellungen mehr Arbeitsspeicher.

Docker Desktop unter Windows installieren

Laden Sie Docker Desktop von der offiziellen Docker-Website herunter. Vermeiden Sie Drittanbieter-Download-Spiegel für Entwickler-Tools.

Führen Sie das .exe-Installationsprogramm aus und lassen Sie die WSL 2-Option aktiviert, wenn sie angezeigt wird. Wenn das Installationsprogramm anbietet, erforderliche Windows-Komponenten hinzuzufügen, erlauben Sie es. Starten Sie Ihren Computer nach der Installation neu, wenn Sie dazu aufgefordert werden.

Öffnen Sie Docker Desktop über das Startmenü. Akzeptieren Sie beim ersten Start die Lizenzbedingungen und lassen Sie Docker die Einrichtung abschließen. Wenn Docker ein WSL-Problem meldet, aktualisieren Sie WSL und versuchen Sie es erneut:

wsl --update

Wenn Sie ein Firmen-Laptop verwenden, kann Endpunkt-Sicherheitssoftware die Virtualisierung oder lokale Netzwerke beeinträchtigen. Überprüfen Sie in diesem Fall die Docker Desktop-Richtlinie Ihres Unternehmens, bevor Sie Firewall- oder Antiviren-Einstellungen ändern.

Docker Desktop unter macOS installieren

Laden Sie Docker Desktop für Mac von der offiziellen Docker-Website herunter. Wählen Sie das Apple Silicon-Installationsprogramm für M-Serie-Macs und das Intel-Installationsprogramm für Intel-Macs.

Öffnen Sie die .dmg-Datei und ziehen Sie Docker in den Programme-Ordner. Starten Sie Docker über Programme. macOS fragt möglicherweise nach Ihrem Passwort oder der Erlaubnis, Hilfskomponenten für Netzwerk und Virtualisierung zu installieren.

Wenn Docker Desktop startet, warten Sie, bis das Menüleistensymbol anzeigt, dass Docker läuft. Der erste Start kann länger dauern, da Docker seine lokale VM und den Speicher erstellt.

Installation überprüfen

Öffnen Sie ein Terminal und überprüfen Sie den Docker-Client und -Server:

docker version

Sie sollten sowohl einen Client-Abschnitt als auch einen Server-Abschnitt sehen. Wenn Sie nur Client-Informationen oder einen Fehler zur Verbindung mit dem Daemon sehen, läuft Docker Desktop noch nicht oder konnte nicht gestartet werden.

Führen Sie den Standard-Testcontainer aus:

docker run hello-world

Docker lädt ein kleines Image herunter und führt es aus. Ein erfolgreicher Lauf gibt eine Meldung aus, die erklärt, dass Docker funktioniert.

Sie können auch Docker Compose überprüfen:

docker compose version

Verwenden Sie den durch Leerzeichen getrennten Befehl docker compose für Compose v2, der in Docker Desktop enthalten ist.

Erste Einstellungen anpassen

Öffnen Sie die Docker Desktop-Einstellungen nach dem ersten erfolgreichen Test.

Unter Windows überprüfen Sie Ressourcen > WSL-Integration und aktivieren Sie die Integration für die Linux-Distributionen, in denen Sie Entwicklungsbefehle ausführen. Wenn Sie Ubuntu in WSL verwenden, können Sie so docker aus der Ubuntu-Shell ausführen.

Überprüfen Sie unter Windows und macOS die Ressourcen. Kleine Projekte laufen möglicherweise gut mit den Standardeinstellungen, aber lokales Kubernetes, Datenbanken und große Builds benötigen oft mehr Arbeitsspeicher oder Festplattenspeicher.

Aktivieren Sie Kubernetes nur, wenn Sie einen lokalen Single-Node-Cluster benötigen. Wenn Sie es deaktiviert lassen, bleibt Docker Desktop schlanker.

Häufige Installationsprobleme

Wenn Docker unter Windows nicht startet, überprüfen Sie zuerst, ob die Virtualisierung aktiviert und WSL installiert ist:

wsl --status

Wenn WSL veraltet ist, führen Sie Folgendes aus:

wsl --update

Wenn docker version keine Verbindung zum Docker-Daemon herstellen kann, stellen Sie sicher, dass Docker Desktop läuft und den Start abgeschlossen hat. Überprüfen Sie unter macOS das Menüleistensymbol. Überprüfen Sie unter Windows das Infobereich-Symbol.

Wenn ein Testcontainer das Netzwerk nicht erreichen kann, testen Sie von einem anderen Netzwerk oder VPN-Status aus. VPN-Clients und Unternehmens-Proxys beeinträchtigen oft das Docker-Netzwerk. Docker Desktop hat Proxy-Einstellungen, die Sie konfigurieren können, wenn Ihre Umgebung dies erfordert.

Sobald docker run hello-world funktioniert, ist Ihre lokale Container-Umgebung bereit. Ein guter nächster Schritt ist die Ausführung eines Dienstes, den Sie bereits kennen, wie Nginx:

docker run --rm -p 8080:80 nginx

Öffnen Sie dann http://localhost:8080. Wenn Sie die Nginx-Willkommensseite sehen, kann Docker Images pullen, Container starten und Ports auf Ihrem Rechner veröffentlichen.