Docker auf Debian installieren

Docker ist die Grundlage für fast alle Anwendungs-Tutorials in der Serverküche. Wir installieren es aus dem offiziellen Docker-Repository – nicht aus den Debian-Paketquellen.

Was bauen wir?

Am Ende läuft die aktuelle Docker Engine samt Compose-Plugin auf deinem Debian 13, installiert aus dem offiziellen Docker-Repository. Das bringt zwei Vorteile gegenüber dem Debian-Paket docker.io: aktuellere Versionen mit zeitnahen Sicherheitsupdates und das offizielle docker compose, auf dem alle Compose-Rezepte hier aufbauen.

Voraussetzungen

• Ein abgesicherter Server mit sudo-Benutzer

Schritt für Schritt

Schritt 1: Repository-Schlüssel einrichten

Installiere zunächst die Werkzeuge, um das Docker-Repository verifizieren zu können:

sudo apt update
sudo apt install -y ca-certificates curl

Lege dann das Schlüsselverzeichnis an und lade den GPG-Schlüssel von Docker herunter – damit prüft apt später, dass die Pakete wirklich von Docker stammen:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc

Schritt 2: Docker-Paketquelle hinzufügen

Trage das Docker-Repository in die Paketquellen ein. Der Befehl ermittelt Architektur und Debian-Version automatisch, du kannst ihn unverändert kopieren:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Schritt 3: Docker installieren

Paketlisten neu einlesen (jetzt inklusive Docker-Repository) und die Engine samt Compose-Plugin installieren:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Prüfe, dass der Dienst läuft:

sudo systemctl status docker

Du solltest active (running) sehen. Ein kurzer Funktionstest:

sudo docker run --rm hello-world

Die Ausgabe Hello from Docker! bestätigt, dass die Installation funktioniert.

Zum Schluss noch prüfen, welche Versionen tatsächlich installiert wurden – das ist die Angabe, die du bei Problemen in jedem Bugreport brauchst:

docker --version
docker compose version

Docker version 29.7.2, build a7dcaa6
Docker Compose version v5.4.0

Die genauen Patch-Nummern verschieben sich laufend; entscheidend ist, dass die Engine bei 29.x und Compose bei v5.x liegt – darauf bauen die Compose-Rezepte hier auf.

Schritt 4: Docker ohne sudo nutzen

Füge deinen Benutzer der Gruppe docker hinzu, damit du nicht vor jeden Befehl sudo setzen musst:

sudo usermod -aG docker $USER

Danach funktioniert docker ps ohne sudo und zeigt eine (noch leere) Container-Liste.

Wenn es nicht funktioniert

Wartung & Backups

• Updates: Docker aktualisiert sich über das normale sudo apt update && sudo apt upgrade mit – ein Grund, warum wir das offizielle Repository nutzen. Beim Update der Engine starten laufende Container kurz neu (bzw. stoppen, bis du sie wieder startest) – plane das ein.
• Aufräumen: Ungenutzte Images und Build-Reste sammeln sich schnell an. docker system df zeigt den Verbrauch, docker system prune räumt auf (Vorsicht: entfernt auch gestoppte Container).
• Backups: Die eigentlichen Daten deiner Anwendungen liegen später in Volumes bzw. Bind-Mounts – die Backup-Strategie dafür bauen wir mit verschlüsselten Restic-Backups und in den jeweiligen Anwendungs-Tutorials.