So installieren Sie Docker unter Ubuntu: Eine vollständige Schritt-für-Schritt-Anleitung

Docker unter Ubuntu zum Laufen zu bringen, ist nicht immer ein Kinderspiel, insbesondere wenn Dinge nicht funktionieren oder nicht sofort funktionieren. Vielleicht haben Sie versucht, es zu installieren, aber Befehle wie „Docker“ werden nicht erkannt oder Container lassen sich einfach nicht verbinden – echt frustrierend. Diese Anleitung führt Sie durch die gängigsten Methoden, von der Installation aus offiziellen Repos bis hin zu Offline-Paketen, und gibt Ihnen Tipps zur Fehlerbehebung und zum Bereinigen alter Versionen. Denn Linux macht es natürlich manchmal komplizierter als nötig. Sobald Sie es eingerichtet haben, können Sie Container ausführen, lokal testen und sogar in der Produktion einsetzen. Sie erhalten mit minimalem Aufwand ein funktionierendes Docker-Setup und ein paar Ideen, falls etwas schiefgeht.

So beheben Sie Docker-Installations- und Ausführungsprobleme unter Ubuntu

Stellen Sie sicher, dass keine widersprüchlichen oder veralteten Docker-Pakete die Dinge durcheinander bringen

Zunächst einmal kommt es selten vor, dass übrig gebliebene Pakete später keine Probleme verursachen. Entfernen Sie alles, was stören könnte:

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove -y "$pkg" done 

Dies hilft, den Überblick zu behalten. Manchmal verursachen alte Versionen oder widersprüchliche Tools Fehler wie „Befehl nicht gefunden“ oder Probleme beim Daemon-Start. Bei manchen Setups kann ein anschließender Neustart die Synchronisierung wieder herstellen.

Überprüfen Sie Ihre Ubuntu-Version und -Architektur – kennen Sie Ihre Umgebung

Bevor Sie sich in die Befehle vertiefen, überprüfen Sie, ob Ihr Betriebssystem und Ihre CPU-Architektur den Erwartungen entsprechen. Führen Sie Folgendes aus:

source /etc/os-release && echo "Ubuntu codename: ${UBUNTU_CODENAME:-$VERSION_CODENAME}" dpkg --print-architecture 

Dies bestätigt lediglich, dass Sie mit den richtigen Repo- und Paketversionen arbeiten. Manchmal führt eine falsche Architektur zu fehlerhaften Installationen oder nicht übereinstimmenden Paketen.

Methode 1: Installieren Sie Docker aus dem offiziellen APT-Repository

Dies ist die erste Wahl für die meisten, die ein stabiles, einfach zu verwaltendes Setup wünschen. Sie erhalten die neueste offizielle Docker-Version mit Updates direkt aus der Quelle. Hilft, die Abhängigkeitshölle zu vermeiden.

Installieren Sie die erforderlichen Pakete und fügen Sie den GPG-Schlüssel hinzu

Dieser Schritt installiert Tools wie ca-certificates und curl und fügt den GPG-Schlüssel von Docker hinzu. Das ist ziemlich unkompliziert, aber wenn Sie hier einen Schritt auslassen, kann apt möglicherweise nicht überprüfen, ob Sie legitime Docker-Pakete abrufen, was schlecht ist.

sudo apt-get update sudo apt-get install -y ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc 

Fügen Sie das offizielle Repository von Docker hinzu

Hier teilen Sie Ihrem System mit, wo Docker-Pakete zu finden sind. Es handelt sich um einen einfachen Echo-Befehl. Achten Sie jedoch darauf, $(./etc/os-release && echo “${UBUNTU_CODENAME}”) korrekt zu ersetzen. Manchmal wird es nicht wie erwartet erweitert, insbesondere wenn Ihr Betriebssystem nicht dem Standard entspricht.

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

Installieren Sie Docker Engine und CLI-Tools

Installieren Sie nun einfach die eigentlichen Container und die CLI. Normalerweise funktioniert dies reibungslos, aber bei einem ungewöhnlichen Setup müssen Sie möglicherweise bestimmte Versionsnummern angeben oder auf fehlerhafte Abhängigkeiten prüfen.

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

Überprüfen Sie, ob Docker installiert ist und ausgeführt wird

Wenn dabei keine Fehler auftreten, überprüfen Sie den Status des Daemons:

sudo systemctl status docker --no-pager docker run hello-world 

Dieser Test ruft ein kleines Image ab und führt es aus. Wenn es funktioniert, ist Ihr Docker-Setup grundsätzlich in Ordnung. Auf manchen Rechnern müssen Sie Ihren Benutzer möglicherweise der Einfachheit halber zur Docker-Gruppe hinzufügen:

sudo usermod -aG docker $USER newgrp docker docker run hello-world 

Ich bin mir nicht sicher, warum, aber manchmal ist ein neuer Grp-Befehl oder eine erneute Anmeldung erforderlich, damit Gruppenänderungen ohne Neustart wirksam werden.

Aktualisieren oder Installieren bestimmter Docker-Versionen

Wenn Sie eine bestimmte Version benötigen, prüfen Sie die verfügbaren Versionen mit:

apt-cache madison docker-ce | awk '{ print $3 }' 

Installieren Sie dann Ihre Wahl wie:

sudo apt-get install -y docker-ce=<version> docker-ce-cli=<version> containerd.io 

Denn manchmal benötigen Sie aus Kompatibilitätsgründen nur diesen speziellen Build. Beachten Sie jedoch, dass bei einigen Setups Downgrades oder bestimmte Versionen schwierig werden können, wenn die Repositories nicht aktualisiert werden.

Methode 2: Offline-Installation über.deb-Pakete

Ideal, wenn Server isoliert sind oder der Internetzugang lückenhaft ist. Sie müssen zuerst alle Dateien abrufen und sie dann lokal installieren.

Docker-Pakete manuell herunterladen

Gehen Sie zum Ubuntu-Repository von Docker und wählen Sie Ihre Architektur (z. B.amd64 oder arm64 ).Rufen Sie diese.deb-Dateien ab:

• containerd.io_<version>_<arch>.deb
• docker-ce_<version>_<arch>.deb
• docker-ce-cli_<version>_<arch>.deb
• docker-buildx-plugin_<version>_<arch>.deb
• docker-compose-plugin_<version>_<arch>.deb

Nach dem Download alles auf einmal installieren:

sudo dpkg -i./containerd.io_*_*.deb \./docker-ce_*_*.deb \./docker-ce-cli_*_*.deb \./docker-buildx-plugin_*_*.deb \./docker-compose-plugin_*_*.deb 

Dies fühlt sich etwas umständlicher an, ist aber ohne Internet die einzige Option und funktioniert auf einigen Systemen zuverlässiger.

Methode 3: Verwenden des offiziellen Komfortskripts von Docker

Wenn Geschwindigkeit wichtiger ist als Sicherheit (nicht für die Produktion empfohlen!), führen Sie einfach Folgendes aus:

curl -fsSL https://get.docker.com -o get-docker.sh sudo sh./get-docker.sh --dry-run # preview, then run without --dry-run sudo sh./get-docker.sh 

Bei dieser Methode wird alles heruntergeladen und mit minimalem Aufwand eingerichtet. Der Nachteil? Keine Kontrolle über Versionen oder Abhängigkeiten, und bei kritischen Systemen ist die Lösung etwas lückenhaft.

Docker Desktop unter Ubuntu installieren

Für eine GUI-Erfahrung mit Docker fügt Desktop eine benutzerfreundliche Ebene hinzu – ähnlich wie Docker in Ihrer Taskleiste. Sie benötigen Ubuntu 22.04 oder neuer, mit GNOME-Terminal, wenn Sie nicht mit GNOME arbeiten.

Desktop-Repository einrichten und installieren

Wiederholen Sie grundsätzlich die Repo-Einrichtung von Methode 1, installieren Sie dann aber:

sudo apt-get install -y./docker-desktop-amd64.deb 

Starten Sie es und aktivieren Sie es für den automatischen Start:

systemctl --user start docker-desktop systemctl --user enable docker-desktop 

Überprüfungen nach der Installation und allgemeine Fehlerbehebung

docker run hello-world docker run -d -p 8080:80 --name web nginx docker ps sudo systemctl enable docker 

Einige typische Probleme:

• docker: command not found→ Installieren Sie Docker CLI neu oder überprüfen Sie, ob Ihr PATH /usr/bin oder /usr/local/bin enthält.
• Verbindung zum Daemon kann nicht hergestellt werden → Stellen Sie sicher, dass der Docker-Dienst aktiv ist und Ihr Benutzer in der Docker -Gruppe ist.
• Fehler beim Abrufen von Images → Überprüfen Sie die Netzwerkeinstellungen, den Proxy, DNS oder die Zeitsynchronisierung (NTP).Manchmal kann Docker Docker Hub nicht erreichen.
• Firewall-Probleme → Möglicherweise müssen Sie Regeln in der DOCKER-USER- Kette oder Ihrer Firewall hinzufügen, um Container-Port-Verkehr zuzulassen.

Deinstallieren von Docker bei Bedarf

sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras sudo rm -rf /var/lib/docker /var/lib/containerd sudo rm -f /etc/apt/sources.list.d/docker.list /etc/apt/keyrings/docker.asc 

Zusammenfassung

Docker unter Ubuntu zu installieren, kann etwas mühsam sein, insbesondere mit all den beweglichen Teilen – Kernel-Versionen, Abhängigkeiten, Firewall-Kram. Sobald es aber funktioniert, ist es für die Containerverwaltung ziemlich zuverlässig. Die offiziellen Methoden decken nahezu jedes Szenario ab, von Online-Installationen bis hin zu Offline-Setups, und die Schritte zur Fehlerbehebung beheben in der Regel die Probleme. Wenn das Setup endlich funktioniert, ist das eine Erleichterung, und Sie können praktisch sofort mit dem Erstellen oder Bereitstellen von Containern beginnen.

Zusammenfassung

• Entfernen Sie zuerst widersprüchliche Pakete
• Wählen Sie die richtige Installationsmethode basierend auf Ihrer Umgebung
• Überprüfen Sie mit einem schnellen Containertest, ob Docker ausgeführt wird
• Halten Sie Docker auf dem neuesten Stand und überprüfen Sie bei Bedarf die Firewall-Regeln
• Entfernen Sie ältere Setups sauber, wenn Sie die Methode wechseln

Daumen drücken, das hilft