Portainer einrichten 2026: Docker bequem im Browser verwalten

Portainer ist die grafische Verwaltung für Docker: Statt jeden Container per Kommandozeile zu starten, zu stoppen und zu überwachen, klickst du dich durch eine aufgeräumte Weboberfläche. Container, Images, Volumes, Netzwerke und komplette Compose-Stacks landen dort in einem Dashboard, das du von jedem Gerät im Heimnetz per Browser erreichst. Für alle, die zu Hause einen kleinen Server betreiben und nicht jede Aktion in die Shell tippen wollen, ist Portainer eines der ersten Tools, das nach Docker selbst installiert wird.

Für wen sich Portainer lohnt

Portainer richtet sich in erster Linie an Homeserver-Einsteiger. Du hast Docker gerade zum Laufen gebracht, dein erster Container startet, aber jedes Update, jeder Log-Blick und jeder Neustart bedeutet: Terminal auf, Befehl nachschlagen, tippen. Genau hier nimmt dir Portainer die Angst vor der Kommandozeile. Du siehst auf einen Blick, welche Container laufen, wie viel Speicher sie fressen und wo gerade etwas klemmt.

Aber auch Profis haben ihre Freude daran. Wenn auf einem Server ein Dutzend Container arbeitet, ist eine grafische Übersicht schneller erfasst als eine lange docker ps-Ausgabe. Portainer ersetzt die CLI nicht, es ergänzt sie. Wer seinen ersten Homeserver plant, findet in unserer Anleitung Homeserver selber bauen die passende Hardware-Grundlage, und wer lieber auf einem sparsamen Einplatinenrechner startet, liest zuerst Raspberry Pi als Homeserver.

Portainer CE oder Business Edition?

Portainer gibt es in zwei Varianten. Die Community Edition (CE) ist quelloffen, komplett kostenlos und für den Heimgebrauch mehr als ausreichend. Container verwalten, Stacks deployen, Logs lesen, Images aktualisieren: All das kann die CE ohne Einschränkung. Für 99 Prozent der Leser dieses Artikels ist sie die richtige Wahl.

Die Business Edition (BE) bringt zusätzliche Funktionen für Unternehmen mit: feingranulare Rechteverwaltung, Anbindung an Active Directory, Registry-Management und offiziellen Support. Interessant ist, dass Portainer für die BE eine kostenlose Lizenz für bis zu drei Nodes anbietet. Wer im Heimlabor die Enterprise-Features ausprobieren will, kann das also legal und gratis tun. Notwendig ist es zu Hause aber nicht, und ich empfehle Einsteigern klar die CE. Weniger Optionen bedeuten hier weniger Verwirrung.

Voraussetzung: Docker installieren

Portainer verwaltet Docker, also muss Docker zuerst laufen. Auf Debian oder Ubuntu geht das am schnellsten über das offizielle Komfort-Skript. Öffne ein Terminal und führe aus:

1. Skript herunterladen und ausführen: curl -fsSL https://get.docker.com | sh
2. Prüfen, ob der Dienst läuft: sudo systemctl status docker

Das Skript erledigt Paketquellen, Schlüssel und Installation in einem Rutsch. Wer es lieber sauber über die offiziellen Paketquellen macht, folgt der Docker-Dokumentation und installiert die Pakete docker-ce, docker-ce-cli und containerd.io von Hand. Für den Heimserver ist das Skript aber völlig in Ordnung.

Damit du Docker-Befehle ohne sudo absetzen kannst, füge deinen Benutzer der docker-Gruppe hinzu:

1. Benutzer zur Gruppe hinzufügen: sudo usermod -aG docker $USER
2. Danach einmal ab- und wieder anmelden, damit die Gruppe greift.

Ein kleiner, aber wichtiger Sicherheitshinweis vorweg: Mitglied der docker-Gruppe zu sein ist praktisch gleichbedeutend mit Root-Rechten auf dem Host. Nimm nur Benutzer auf, denen du diese Macht zugestehst.

Portainer installieren: Schritt für Schritt

Jetzt kommt der eigentliche Teil. Portainer läuft selbst als Container und speichert seine Daten in einem eigenen Volume. So bleiben deine Einstellungen erhalten, auch wenn du den Container später neu erstellst.

1. Lege zuerst ein Volume für die Portainer-Daten an: docker volume create portainer_data
2. Starte den Portainer-Container mit diesem Befehl:
   

   docker run -d -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

3. Öffne im Browser die Adresse https://IP-DEINES-SERVERS:9443. Weil Portainer ein selbst signiertes Zertifikat nutzt, zeigt der Browser eine Warnung. Das ist im Heimnetz normal, du kannst die Ausnahme bestätigen.
4. Lege beim ersten Aufruf das Admin-Konto an: Benutzername und ein starkes Passwort mit mindestens zwölf Zeichen.
5. Wähle im nächsten Schritt die Umgebung local, damit Portainer den Docker auf demselben Rechner verwaltet.

Ein Detail, über das viele stolpern: Nach dem Start des Containers hast du nur ein Zeitfenster von etwa fünf Minuten, um das Admin-Konto anzulegen. Lässt du dir länger Zeit, sperrt Portainer aus Sicherheitsgründen die Ersteinrichtung. Passiert dir das, ist es kein Drama. Starte den Container einfach neu mit docker restart portainer und rufe die Seite erneut auf. Das Fenster öffnet sich dann von vorn.

Sicherheit zuerst: Wer den Docker-Socket (/var/run/docker.sock) in einen Container reicht, gibt diesem Container faktisch Root-Zugriff auf den gesamten Host. Portainer braucht das, um Docker zu steuern, aber es bedeutet auch: Stelle Portainer niemals ungeschützt ins offene Internet. Bleib im Heimnetz, oder sichere den Zugriff über ein VPN wie WireGuard oder einen Reverse Proxy mit Authentifizierung ab. Ein offener Port 9443 an einer öffentlichen IP ist ein Einfallstor, das du nicht haben willst.

Die wichtigsten Funktionen im Alltag

Ist Portainer eingerichtet, landest du im Dashboard deiner lokalen Umgebung. Von hier aus erreichst du alles, was du im Docker-Alltag brauchst.

Container verwalten

Unter Containers siehst du die vollständige Liste aller Container mit Status, Port-Zuordnung und Ressourcenverbrauch. Ein Klick auf einen Container öffnet die Detailansicht. Dort kannst du ihn starten, stoppen, neu starten oder entfernen. Besonders praktisch: Über Logs liest du die Ausgabe des Containers live mit, ohne docker logs tippen zu müssen. Und über Console öffnest du eine Shell direkt im Container, etwa um eine Konfigurationsdatei zu prüfen.

Images aktualisieren

Docker-Images bekommen Updates, und Portainer macht das Nachziehen einfach. In der Detailansicht eines Containers findest du die Funktion Recreate. Aktivierst du dabei die Option Re-pull image, holt Portainer die neueste Version des Images und erstellt den Container damit neu. Deine Volumes bleiben erhalten, die Daten also auch. Das ist der bequemste Weg, einen einzelnen Container auf den aktuellen Stand zu bringen.

Volumes und Netzwerke

Unter Volumes verwaltest du die persistenten Datenspeicher deiner Container. Du siehst, welches Volume von welchem Container genutzt wird, und kannst verwaiste Volumes aufräumen. Der Bereich Networks zeigt die Docker-Netzwerke und lässt dich eigene anlegen, etwa um mehrere Container voneinander zu isolieren oder gezielt miteinander kommunizieren zu lassen.

Stacks: Docker Compose im Browser

Der vielleicht stärkste Teil von Portainer sind die Stacks. Ein Stack ist nichts anderes als eine Docker-Compose-Datei, nur dass du sie direkt im Browser bearbeitest und deployst. Statt eine docker-compose.yml per SSH auf den Server zu kopieren, fügst du sie in den Web-Editor ein und klickst auf Deploy.

Ein einfaches Beispiel: Uptime Kuma, ein schöner Monitor für die Erreichbarkeit deiner Dienste. Der Stack sieht so aus:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    ports:
      - "3001:3001"
    volumes:
      - uptime-kuma:/app/data
    restart: always
volumes:
  uptime-kuma:

Du gehst dazu auf Stacks, klickst auf Add stack, gibst einen Namen ein und fügst das YAML in den Web-Editor. Braucht dein Stack Zugangsdaten oder Pfade, definierst du sie unten als Environment variables, sodass keine Passwörter im Klartext im YAML stehen. Nach Deploy the stack zieht Portainer die Images und startet alles. Änderst du später etwas am YAML, genügt ein Klick auf Update the stack für ein sauberes Redeploy.

Genau so bringst du auch bekannte Dienste ins Haus. Ein Pi-hole als Werbeblocker fürs ganze Netz oder ein Immich als Foto-Server lassen sich als Stack in wenigen Minuten aufsetzen. Wer den Unterschied zwischen Containern und vollwertigen virtuellen Maschinen verstehen will, findet in unserem Artikel zu Proxmox die passende Abgrenzung: Proxmox virtualisiert ganze Betriebssysteme, Docker teilt sich einen Kernel.

App-Templates für den schnellen Start

Wer nicht selbst YAML schreiben mag, findet unter App Templates eine Sammlung fertiger Vorlagen für gängige Anwendungen. Ein Klick, ein paar Felder ausfüllen, fertig. Für den Einstieg ist das ein netter Weg, auf Dauer gibt dir ein eigener Stack aber mehr Kontrolle.

Portainer selbst aktualisieren

Auch Portainer bekommt regelmäßig Updates. Da es als Container läuft, ist die Aktualisierung schnell erledigt:

1. Neues Image holen: docker pull portainer/portainer-ce:latest
2. Alten Container stoppen und entfernen: docker stop portainer && docker rm portainer
3. Container mit demselben docker run-Befehl wie oben neu starten.

Weil deine Konfiguration im Volume portainer_data liegt, bleiben Benutzer, Einstellungen und Stacks vollständig erhalten. Der neue Container übernimmt einfach den alten Datenstand.

Wo Portainer an Grenzen stößt

So praktisch die Oberfläche ist, ehrlich muss man sagen: Portainer ersetzt kein Verständnis der Docker-Grundlagen. Wer nicht weiß, was ein Volume, ein Port-Mapping oder ein Netzwerk ist, klickt sich schnell in eine Sackgasse. Die grafische Hülle nimmt dir die Tipparbeit ab, nicht das Denken.

Und wenn ein Stack wirklich kaputt ist, ein Container also immer wieder abstürzt oder gar nicht erst startet, hilft am Ende oft doch die Kommandozeile. Ein docker logs mit vollem Fehlertext oder ein manuelles docker compose up zeigt manchmal mehr als die Weboberfläche. Als schlankere Alternative, die sich ganz auf Compose-Stacks konzentriert, ist Dockge einen Blick wert. Und für schnelle Einzelaktionen bleibt die pure Docker-CLI unschlagbar. Portainer ist ein Werkzeug im Kasten, nicht der ganze Kasten.

Troubleshooting: die häufigsten Stolpersteine

• Timeout bei der Erstanmeldung: Du siehst die Meldung, dass die Einrichtung abgelaufen ist. Das ist das erwähnte Fünf-Minuten-Fenster. Starte den Container mit docker restart portainer neu und rufe die Seite sofort wieder auf.
• Port 9443 ist belegt: Läuft schon ein anderer Dienst auf dem Port, ändere das Mapping beim Start, etwa -p 9444:9443, und rufe Portainer dann über den neuen Port auf.
• „Environment down“: Portainer meldet, dass die lokale Umgebung nicht erreichbar ist. Meist stimmt dann etwas mit der Einbindung des Docker-Sockets nicht. Prüfe, ob /var/run/docker.sock im docker run-Befehl korrekt gemountet ist und ob der Docker-Dienst überhaupt läuft.
• Berechtigungen auf docker.sock: Erscheinen Fehler zu fehlenden Rechten, liegt es fast immer am Zugriff auf den Socket. Der Portainer-Container braucht Lesezugriff darauf, und dein Benutzer sollte in der docker-Gruppe sein.

Fazit

Portainer ist für viele der Moment, in dem der eigene Homeserver vom Terminal-Abenteuer zum entspannten Hobby wird. Die Community Edition ist kostenlos, in wenigen Minuten eingerichtet und nimmt dir im Alltag jede Menge Tipparbeit ab. Container im Blick behalten, Logs lesen, Stacks deployen, Images aktualisieren: Das alles geht bequem im Browser. Wichtig bleibt der Sicherheitsaspekt, denn der Zugriff auf den Docker-Socket ist mächtig und gehört nie ungeschützt ins Internet. Und ganz ohne Docker-Wissen geht es auch mit Portainer nicht. Wer diese beiden Punkte beherzigt, bekommt aber ein Werkzeug, das den Serveralltag spürbar leichter macht.

Häufige Fragen

Ist Portainer kostenlos?

Ja. Die Community Edition ist quelloffen und komplett kostenlos, ohne Funktionslimit für den Heimgebrauch. Nur die Business Edition kostet Geld, bietet aber eine kostenlose Lizenz für bis zu drei Nodes. Für zu Hause reicht die CE vollkommen aus.

Portainer oder Docker Compose, was ist besser?

Das ist kein Entweder-oder. Portainer nutzt unter der Haube dieselbe Compose-Logik, du bearbeitest deine Stacks nur im Browser statt in einer Datei per SSH. Wer lieber grafisch arbeitet, nimmt Portainer. Wer Konfigurationen versionieren und in Git ablegen will, bleibt bei der reinen Compose-Datei. Beides lässt sich sogar kombinieren.

Läuft Portainer auf dem Raspberry Pi?

Ja, problemlos. Das Image portainer/portainer-ce ist für ARM verfügbar, sodass Portainer auf einem Raspberry Pi 4 oder 5 genauso läuft wie auf einem x86-Server. Ein Pi mit SSD ist eine sparsame und beliebte Basis für einen kleinen Docker-Server.

Wie update ich Portainer?

Du holst das neue Image mit docker pull portainer/portainer-ce:latest, entfernst den alten Container und startest ihn mit demselben docker run-Befehl neu. Weil alle Daten im Volume portainer_data liegen, bleiben deine Einstellungen und Stacks erhalten.

Kann ich mehrere Server verwalten?

Ja. Portainer kann neben der lokalen Umgebung weitere Docker-Hosts einbinden, etwa über den Portainer-Agent, den du auf den anderen Servern installierst. So verwaltest du mehrere Maschinen zentral aus einer Oberfläche. Für das feingranulare Rechte-Management über viele Nodes hinweg ist allerdings die Business Edition gedacht.