Raspberry Pi Docker installieren

Wer auf dem Raspberry Pi Docker installieren möchte, legt damit das Fundament für ein flexibles, ressourcenschonendes Homelab. Docker ist die verbreitetste Software für Container-Virtualisierung und lässt Programme sauber getrennt vom restlichen Betriebssystem laufen. Das reduziert Konflikte zwischen Abhängigkeiten, macht Dienste portabel und erlaubt es, eine Anwendung mit einem einzigen Befehl aufzusetzen oder wieder zu entfernen. Gerade auf einem Raspberry Pi 4 mit 8 GB RAM lohnt sich Virtualisierung richtig, weil du damit mehrere Dienste parallel betreiben kannst, ohne für jeden ein eigenes Gerät anzuschaffen.

In dieser Anleitung richtest du Docker unter Raspberry Pi OS Schritt für Schritt ein: vom System-Update über die Installation per offiziellem Skript bis zur Rechtevergabe und einem ersten Test-Container. Am Ende läuft die Docker-Engine stabil und startet nach jedem Neustart automatisch.

Voraussetzungen für die Docker-Installation

Auf den meisten Geräten läuft Raspberry Pi OS (früher Raspbian), das auf Debian basiert. Damit kannst du Docker bequem aus dem offiziellen Installationsskript beziehen. Empfehlenswert ist ein 64-Bit-System, da viele aktuelle Container-Images nur noch für die ARM64-Architektur bereitstehen. Für die Einrichtung brauchst du:

einen Raspberry Pi 3, 4 oder 5 mit installiertem Raspberry Pi OS
eine funktionierende Internetverbindung
Terminal-Zugriff, entweder direkt am Gerät oder komfortabel per SSH

Raspberry Pi OS: Docker installieren

Schritt 1: System aktualisieren

Melde dich per SSH auf dem Raspberry Pi an und bringe das System zunächst auf den aktuellen Stand. So vermeidest du Paketkonflikte während der Installation:

sudo apt update && sudo apt full-upgrade -y

Der erste Teil aktualisiert die Paketlisten, der zweite installiert alle verfügbaren Updates. Nach einem größeren Upgrade schadet ein Neustart mit sudo reboot nicht.

Siehe auch Homelab: Was es ist, warum sich der Aufbau lohnt und welchen Nutzen es bietet

Schritt 2: Docker per offiziellem Skript installieren

Der einfachste Weg führt über das Convenience-Skript von Docker. Es erkennt die Architektur des Raspberry Pi automatisch und richtet die passenden Paketquellen ein. Lade das Skript zunächst herunter und speichere es unter dem Namen install-docker.sh:

curl -fsSL https://get.docker.com -o install-docker.sh

Bevor du ein fremdes Skript mit Root-Rechten ausführst, lohnt sich ein prüfender Blick in den Inhalt. Öffne die Datei dazu kurz mit einem Editor oder einem Pager. Anschließend startest du die eigentliche Installation:

sudo sh install-docker.sh

Das Skript fügt das Docker-Repository hinzu und installiert Engine, CLI sowie das Plugin für Docker Compose. Nach wenigen Minuten ist Docker erfolgreich eingerichtet.

Schritt 3: Benutzer zur docker-Gruppe hinzufügen

Standardmäßig lässt sich Docker nur mit sudo bedienen. Damit du die Befehle ohne vorangestelltes sudo nutzen kannst, fügst du deinen Benutzer der Gruppe docker hinzu:

sudo usermod -aG docker $USER

Melde dich danach einmal ab und wieder an, damit die neue Gruppenzugehörigkeit wirksam wird. Beachte, dass Mitglieder der docker-Gruppe faktisch Root-Rechte auf dem System besitzen.

Installation testen und Autostart aktivieren

Prüfe nun, ob die Docker-Engine korrekt arbeitet. Der folgende Befehl zeigt die installierte Version an und startet anschließend den kleinen Test-Container hello-world:

docker --version
docker run --rm hello-world

Erscheint die Meldung „Hello from Docker!“, läuft alles wie gewünscht. Damit Docker nach jedem Neustart automatisch verfügbar ist, aktivierst du den zugehörigen systemd-Dienst:

sudo systemctl enable docker

Ein sinnvoller nächster Schritt ist, dass auch deine Container nach einem Reboot von selbst wieder hochfahren. Wie das über die passende Neustart-Regel funktioniert, zeigt der Guide zur Docker Restart Policy für automatisch startende Container.

Siehe auch Jellyfin vs. Plex vs. Emby: Der große Media-Server-Vergleich

Nächste Schritte mit Docker auf dem Raspberry Pi

Sobald die Engine steht, verwaltest du deine Anwendungen am besten mit Docker Compose. Damit beschreibst du komplette Setups in einer einzigen YAML-Datei und startest sie mit einem Befehl. Prüfe zunächst, ob das Compose-Plugin bereitsteht:

docker compose version

Für flexible Konfigurationen trennst du Zugangsdaten und Einstellungen sauber vom Compose-File. Wie das gelingt, erklärt der Beitrag zu Docker-Compose-Umgebungsvariablen über die env-Datei. Wer seine Container lieber grafisch statt über die Kommandozeile im Blick behält, kann zusätzlich Portainer installieren und Docker bequem im Browser verwalten.

Fazit

Docker auf dem Raspberry Pi zu installieren ist dank des offiziellen Skripts in wenigen Minuten erledigt. Nach dem System-Update, der Installation und dem Hinzufügen deines Benutzers zur docker-Gruppe steht dir eine schlanke, portable Container-Plattform zur Verfügung. Mit aktiviertem Autostart und Docker Compose baust du daraus im Handumdrehen ein zuverlässiges Homelab, das DNS-Filter, VPN, Smart-Home-Zentrale oder Selfhosting-Dienste parallel betreiben kann.

Häufige Fragen (FAQ)

Läuft Docker auf jedem Raspberry Pi?

Docker läuft ab dem Raspberry Pi 2 grundsätzlich, sinnvoll nutzbar ist es aber vor allem ab dem Pi 3. Für mehrere Container gleichzeitig empfiehlt sich ein Pi 4 oder 5 mit mindestens 4 GB RAM. Wichtig ist ein 64-Bit-Raspberry-Pi-OS, da viele Images nur noch für ARM64 angeboten werden.

Warum sollte ich meinen Benutzer zur docker-Gruppe hinzufügen?

Ohne Mitgliedschaft in der Gruppe docker musst du jeden Befehl mit sudo ausführen. Die Gruppenmitgliedschaft macht die Bedienung komfortabler. Sei dir aber bewusst, dass diese Rechte einem Root-Zugang entsprechen, weshalb du sie nur vertrauenswürdigen Konten geben solltest.

Startet Docker nach einem Neustart automatisch?

Die Docker-Engine selbst startet automatisch, sobald du den Dienst mit sudo systemctl enable docker aktiviert hast. Ob einzelne Container ebenfalls automatisch hochfahren, steuerst du über die Restart Policy des jeweiligen Containers.

Siehe auch Memtest86 bootfähigen USB-Stick erstellen (Windows, Linux & macOS)

Ist das Installationsskript von get.docker.com sicher?

Das Convenience-Skript stammt direkt vom Docker-Projekt und ist für schnelle Einrichtungen gedacht. Da es mit Root-Rechten läuft, solltest du es vor dem Ausführen kurz prüfen. Für produktive Umgebungen empfiehlt Docker die manuelle Installation über die offiziellen Paketquellen.

Wie deinstalliere ich Docker wieder?

Du entfernst Docker über den Paketmanager, indem du die Pakete docker-ce, docker-ce-cli und containerd.io deinstallierst. Zusätzlich kannst du das Verzeichnis /var/lib/docker löschen, um Images, Container und Volumes vollständig zu entfernen.