Docker einrichten: Der komplette Guide für Selbsthoster

Das brauchen Sie vorab

• Ein Rechner mit Ubuntu 22.04 LTS, Ubuntu 24.04 LTS oder neuer, da Docker diese Versionen offiziell unterstützt. Auf Derivaten wie Linux Mint kann es funktionieren, wird aber nicht offiziell getestet.
• Ein 64-Bit-System (amd64 oder arm64), denn Docker Engine wird nur für diese Architekturen bereitgestellt. Sehr alte 32-Bit-Rechner scheiden aus.
• Ein Benutzerkonto mit sudo-Rechten. 'sudo' bedeutet, dass Sie kurzzeitig Verwaltungsrechte bekommen, um Software zu installieren. Ohne diese Rechte lässt sich Docker nicht einrichten.
• Eine funktionierende Internetverbindung, weil die Installationsdateien und später auch die Container-Vorlagen aus dem Netz geladen werden.
• Grundlegende Vertrautheit mit dem Terminal. Das Terminal ist das schwarze Fenster, in das man Textbefehle eintippt. Sie müssen kein Profi sein, aber sollten Befehle abtippen und die Eingabetaste drücken können.

Schritt für Schritt

1. Terminal öffnen und System aktualisieren

   Bevor wir überhaupt mit Docker anfangen, sorgen wir dafür, dass Ihr System auf dem neuesten Stand ist. Das verhindert viele spätere Probleme, weil alte Paketlisten oft zu Fehlern führen.

   Öffnen Sie das Terminal. Unter Ubuntu drücken Sie dazu die Tastenkombination Strg + Alt + T, oder Sie suchen im Anwendungsmenü nach 'Terminal'. Es erscheint ein Fenster mit einer blinkenden Eingabezeile – hier tippen wir gleich Befehle ein.

   Der folgende Befehl macht zwei Dinge: apt update lädt die aktuelle Liste verfügbarer Software herunter, und apt upgrade installiert die neueren Versionen bereits vorhandener Programme. Das Wort 'apt' ist die Paketverwaltung von Ubuntu und Debian – eine Art App-Store für das Terminal.

   sudo apt update && sudo apt upgrade -y

2. Alte oder inoffizielle Docker-Pakete entfernen

   Manchmal sind schon inoffizielle Docker-Versionen aus den Standard-Quellen von Ubuntu installiert. Diese können mit der offiziellen Version in Konflikt geraten, deshalb räumen wir zuerst auf.

   Keine Sorge, wenn dieser Schritt meldet, dass gar nichts zu entfernen ist – das bedeutet einfach, dass Ihr System sauber ist. Der Befehl schadet in diesem Fall nicht.

   Der folgende Befehl versucht, mehrere bekannte alte Pakete gleichzeitig zu entfernen. Der Teil $(dpkg --get-selections ...) sucht dabei automatisch heraus, welche dieser Pakete tatsächlich installiert sind, und übergibt nur diese an den Entfernungsbefehl.

   sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)

3. Docker-Paketquelle einrichten

   Damit Ihr System die offizielle Docker-Version findet, müssen wir Ubuntu mitteilen, wo diese liegt. Das nennt man 'Repository' – ein Repository ist einfach eine Online-Quelle, aus der Software heruntergeladen wird.

   Zuerst installieren wir zwei Hilfsprogramme: ca-certificates sorgt dafür, dass verschlüsselte Verbindungen als vertrauenswürdig erkannt werden, und curl kann Dateien aus dem Internet herunterladen. Danach legen wir einen Ordner für sogenannte Schlüssel an und laden den offiziellen Docker-Schlüssel herunter. Dieser Schlüssel bestätigt, dass die Software wirklich von Docker stammt und nicht manipuliert wurde.

   Führen Sie die folgenden Befehle nacheinander aus. Jede Zeile ist ein eigener Schritt: Der Ordner /etc/apt/keyrings wird erstellt, der Schlüssel wird dort abgelegt und anschließend lesbar gemacht.

   sudo apt update
   sudo apt install ca-certificates curl -y
   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

4. Docker-Repository zur Paketliste hinzufügen

   Jetzt tragen wir die Docker-Quelle offiziell in die Liste der Software-Quellen ein. Erst danach weiß Ihr System, dass es Docker von dort beziehen darf.

   Der folgende Befehl sieht kompliziert aus, aber er erledigt alles automatisch: Er erkennt Ihre Ubuntu-Version und Ihre Systemarchitektur und schreibt die passende Zeile in die Datei /etc/apt/sources.list.d/docker.list. Danach führen wir noch einmal apt update aus, damit die neue Quelle eingelesen wird.

   Nach dem apt update sollten Sie in der Ausgabe eine Zeile sehen, die auf download.docker.com verweist. Das ist das Zeichen, dass die neue Quelle erfolgreich erkannt wurde.

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

5. Docker Engine installieren

   Jetzt kommt der eigentliche Kern: die Installation der Docker Engine. 'Engine' bedeutet hier der Motor, der im Hintergrund läuft und Ihre Container startet, stoppt und verwaltet.

   Wir installieren gleich mehrere Bestandteile: docker-ce ist die Engine selbst, docker-ce-cli ist das Kommandozeilen-Werkzeug zum Steuern, containerd.io ist die tiefe Ebene, die Container tatsächlich ausführt, und die beiden Plugins fügen Zusatzfunktionen wie Docker Compose hinzu.

   Der Download kann je nach Verbindung ein paar Minuten dauern. Am Ende erscheint wieder die normale Eingabezeile ohne Fehlermeldung – das bedeutet, dass alles geklappt hat.

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

6. Installation mit einem Testcontainer prüfen

   Um sicherzugehen, dass Docker wirklich läuft, starten wir einen winzigen Testcontainer namens 'hello-world'. Ein Container ist eine abgeschottete kleine Umgebung, in der ein Programm läuft, ohne den Rest Ihres Systems zu beeinflussen.

   Der Befehl docker run lädt bei Bedarf zuerst das benötigte Abbild (englisch 'Image') aus dem Internet herunter. Ein Image ist die Vorlage, aus der ein Container erzeugt wird – vergleichbar mit einer Schablone.

   Wenn alles funktioniert, sehen Sie eine freundliche Meldung, die mit 'Hello from Docker!' beginnt. Das bestätigt, dass Docker herunterladen, starten und ausführen kann. Genau das wollten wir sehen.

   sudo docker run hello-world

7. Docker ohne sudo nutzbar machen (optional)

   Bisher mussten Sie vor jedem Docker-Befehl sudo schreiben. Das ist auf Dauer umständlich. Sie können Ihren Benutzer zur Gruppe 'docker' hinzufügen, dann geht es auch ohne.

   Wichtig zu wissen: Mitglieder der Gruppe 'docker' haben faktisch weitreichende Rechte auf dem System. Auf Ihrem persönlichen Rechner ist das völlig in Ordnung, auf einem geteilten Server sollten Sie es sich gut überlegen.

   Nach dem folgenden Befehl müssen Sie sich einmal ab- und wieder anmelden (oder den Rechner neu starten), damit die Änderung wirksam wird. Danach können Sie Docker-Befehle ohne sudo ausführen und mit docker run hello-world erneut testen.

   sudo usermod -aG docker $USER

8. Die wichtigsten Grundbefehle kennenlernen

   Jetzt lernen Sie die vier Befehle, die Sie im Alltag am häufigsten brauchen. Wir starten dazu einen echten, nützlichen Container: einen Nginx-Webserver, der eine Webseite ausliefern kann.

   Der Befehl docker run -d -p 8080:80 --name meinweb nginx startet Nginx. Dabei bedeutet -d, dass der Container im Hintergrund läuft ('detached'), -p 8080:80 verbindet Port 8080 Ihres Rechners mit Port 80 im Container (Ports sind wie nummerierte Türen für Netzwerkverbindungen), und --name meinweb gibt dem Container einen leicht merkbaren Namen. Öffnen Sie danach im Browser die Adresse http://localhost:8080, sehen Sie die Nginx-Willkommensseite.

   Mit docker ps sehen Sie alle laufenden Container. docker logs meinweb zeigt Ihnen die Ausgaben (das 'Logbuch') des Containers, was bei der Fehlersuche hilft. Und docker exec -it meinweb bash öffnet eine Kommandozeile direkt im Inneren des Containers, sodass Sie sich darin umsehen können. Mit dem Befehl exit verlassen Sie diese innere Kommandozeile wieder.

   docker run -d -p 8080:80 --name meinweb nginx
   docker ps
   docker logs meinweb
   docker exec -it meinweb bash

9. Docker Compose verstehen und einsetzen

   In der Praxis braucht man oft mehrere Container gleichzeitig, zum Beispiel einen Webserver und eine Datenbank. Von Hand mit vielen docker run-Befehlen wird das schnell unübersichtlich. Genau hier hilft Docker Compose.

   Mit Compose beschreiben Sie in einer einzigen Textdatei namens docker-compose.yml, welche Container Sie haben möchten und wie sie zusammenarbeiten. Danach starten Sie alles mit einem einzigen Befehl. Das Dateiformat heißt YAML – wichtig dabei ist, dass die Einrückungen mit Leerzeichen (keine Tabs) exakt stimmen müssen.

   Legen Sie zuerst einen neuen Ordner an und wechseln hinein, etwa mit mkdir mein-projekt && cd mein-projekt. Erstellen Sie darin die Datei docker-compose.yml mit dem unten gezeigten Inhalt. Anschließend starten Sie das Ganze mit docker compose up -d. Der Container wird gestartet, und unter http://localhost:8081 erreichen Sie den Webserver. Mit docker compose down fahren Sie später alles wieder sauber herunter.

   # Datei: docker-compose.yml
   services:
     web:
       image: nginx
       ports:
         - "8081:80"
   
   # Danach im selben Ordner ausführen:
   docker compose up -d
   docker compose down

Häufige Probleme und Lösungen

Fazit

Sie haben Docker offiziell installiert, mit einem Testcontainer geprüft und die vier zentralen Befehle run, ps, logs und exec praktisch angewendet. Zusätzlich wissen Sie nun, wie Docker Compose mehrere Container über eine einzige Datei bequem verwaltet. Damit haben Sie das Fundament, um eigene Anwendungen sauber verpackt und wiederholbar auf jedem System zu betreiben.

Häufige Fragen