Docker installieren: Linux, Mac, Windows

Hier installierst du Docker, prüfst Compose und startest einen ersten lokalen Webdienst. Für diese Reihe brauchst du Docker und Docker Compose. Auf Mac und Windows ist Docker Desktop der einfachste Einstieg, weil Engine, CLI und Compose zusammenkommen. Auf Linux nutze ich meist Docker Engine mit dem Compose Plugin.

Wichtig: wir verwenden die moderne Schreibweise docker compose mit Leerzeichen. Die alte Schreibweise docker-compose kann dir noch begegnen, ist aber hier nicht der Standard.

Installation nach Betriebssystem

Wähle dein System aus. Die Befehle sind bewusst knapp gehalten, damit du zuerst ein laufendes Docker bekommst und nicht in Spezialfällen hängen bleibst.

Auf Ubuntu oder Debian installiere ich Docker Engine plus Compose Plugin aus den offiziellen Docker-Paketen. Richte zuerst das offizielle Docker-Repository für deine Distribution ein. Danach installierst du diese Pakete:

# Nach dem Einrichten des offiziellen Docker-Repositorys:
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Prüfen:
docker version
docker compose version

Wenn docker version nur mit sudo funktioniert, füge deinen Benutzer zur Docker-Gruppe hinzu und melde dich danach einmal ab und wieder an:

sudo usermod -aG docker $USER

Wenn deine Distribution nicht Ubuntu ist, nimm die passende offizielle Anleitung für Debian, Fedora oder deine Distribution. Wichtig ist am Ende das Paket docker-compose-plugin.

Auf dem Mac ist Docker Desktop der einfachste Weg. Lade Docker Desktop für Apple Silicon oder Intel von docker.com herunter, verschiebe die App nach „Programme“ und starte sie einmal.

# Nach dem Start von Docker Desktop im Terminal prüfen:
docker version
docker compose version

Docker Desktop muss laufen, bevor die Befehle im Terminal funktionieren. Du erkennst das am Docker-Symbol in der Menüleiste.

Auf Windows empfehle ich Docker Desktop mit WSL 2. Installiere Docker Desktop, aktiviere bei der Einrichtung WSL 2 und öffne danach eine neue PowerShell.

# In PowerShell prüfen:
docker version
docker compose version

Wenn Docker nicht startet, prüfe zuerst, ob WSL 2 aktiv ist und Virtualisierung im BIOS/UEFI eingeschaltet wurde.

Erster Compose-Test

Lege einen neuen Ordner an, zum Beispiel docker-test, und erstelle darin eine Datei compose.yml:

services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"

Dann startest du den Dienst:

docker compose up -d
docker compose ps
docker compose logs web

Öffne danach http://localhost:8080. Wenn die Nginx-Startseite erscheint, funktionieren Docker und Compose. Aufräumen kannst du so:

docker compose down

Wenn etwas nicht klappt

Fehlersuche

Wenn docker compose version nicht funktioniert, fehlt meist das Compose Plugin oder Docker Desktop läuft nicht. Wenn localhost:8080 nicht erreichbar ist, prüfe zuerst, ob der Container mit docker compose ps wirklich läuft.

Der nächste sinnvolle Schritt

Wenn du diesen Teil verstanden hast, sind diese Seiten die logisch nächsten Stationen:

Häufige Fragen

Soll ich docker compose oder docker-compose verwenden?

In dieser Reihe verwende ich docker compose mit Leerzeichen. Das ist die moderne Variante des Compose Plugins.

Warum funktioniert Docker manchmal nur mit sudo?

Auf Linux fehlt deinem Benutzer dann meist noch die Docker-Gruppe. Danach musst du dich einmal ab- und wieder anmelden.

Wie prüfe ich, ob Docker richtig installiert ist?

Nutze docker version, docker compose version und einen kleinen Compose-Test mit einem Nginx-Container.