DockerKubernetesHomelab

Portainer: Docker- und Kubernetes-Container per Web-UI verwalten

8 Min. Lesezeit

Wer mehrere Docker-Container betreibt, kennt das Problem: Mit der Zeit wächst die Zahl laufender Dienste, und das Verwalten über die Kommandozeile wird unübersichtlich. Portainer löst dieses Problem mit einer umfassenden Web-Oberfläche, die Container, Images, Volumes, Netzwerke und ganze Stacks grafisch verwaltbar macht – und das nicht nur für Docker, sondern auch für Kubernetes und Docker Swarm.

Was ist Portainer?

Portainer ist eine Open-Source-Verwaltungsoberfläche für Container-Umgebungen. Das Projekt existiert seit 2016 und ist heute eines der meistgenutzten Tools im Homelab- und DevOps-Bereich. Portainer selbst läuft als Docker-Container und kommuniziert mit dem Docker-Socket oder einem Remote-API-Endpunkt. Über eine einzige Weboberfläche lassen sich mehrere Umgebungen gleichzeitig verwalten – ein Raspberry Pi im Heimnetzwerk, ein VPS in der Cloud und ein Kubernetes-Cluster können parallel nebeneinander stehen.

Portainer CE vs. Business Edition

Portainer bietet zwei Varianten an. Die Community Edition (CE) ist kostenlos, Open Source und für die meisten Heimanwender und kleineren Teams mehr als ausreichend. Sie unterstützt Docker, Docker Swarm und Kubernetes, erlaubt das Verwalten mehrerer Umgebungen und bietet alle grundlegenden Features. Die Business Edition (BE) richtet sich an Unternehmen und ergänzt CE um Role-Based Access Control (RBAC), SSO, Audit-Logs, erweiterten Support und zusätzliche Sicherheitsfunktionen. Für Homelab-Zwecke ist CE die richtige Wahl.

Installation

Portainer CE wird als Docker-Container gestartet. Zunächst wird ein Volume für persistente Daten angelegt, danach der Container gestartet:

docker volume create portainer_data

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

Die Weboberfläche ist anschließend unter https://server-ip:9443 erreichbar. Beim ersten Start wird ein Admin-Passwort vergeben. Danach erscheint die Umgebungsübersicht, in der die lokale Docker-Instanz bereits automatisch erkannt wird.

Tipp: Für Remote-Umgebungen – also Docker-Hosts auf anderen Rechnern – kann der Portainer-Agent eingesetzt werden. Dieser läuft ebenfalls als Container auf dem Zielhost und öffnet einen sicheren Kanal zur zentralen Portainer-Instanz. So lassen sich beliebig viele Hosts über ein einziges Dashboard verwalten, ohne den Docker-Socket direkt über das Netzwerk freizugeben.

Stacks: Docker Compose über die Web-UI

Eine der nützlichsten Funktionen von Portainer sind Stacks. Ein Stack entspricht einer docker-compose.yml-Datei, die direkt im Browser eingefügt, bearbeitet und deployed werden kann. Änderungen an einem Stack lassen sich mit einem Klick anwenden, ohne SSH oder Kommandozeile. Portainer speichert die Stack-Definitionen und ermöglicht es, diese aus einem Git-Repository zu beziehen – ideal für GitOps-Workflows.

Für das Homelab bedeutet das: Dienste wie Jellyfin, Pi-hole, Vaultwarden oder Home Assistant lassen sich als einzelne Stacks verwalten, übersichtlich gruppiert und mit klaren Abhängigkeiten. Logs einzelner Container sind per Klick einsehbar, Shell-Zugang direkt über den Browser möglich.

Achtung: Portainer mountet den Docker-Socket (/var/run/docker.sock) in den Container. Das bedeutet, wer Zugriff auf Portainer hat, hat effektiv root-Zugriff auf den Host. Die Weboberfläche sollte daher nicht ohne Authentifizierung und idealerweise nur im lokalen Netzwerk oder hinter einem VPN erreichbar sein.

Kubernetes-Unterstützung

Portainer unterstützt auch Kubernetes-Cluster, einschließlich leichtgewichtiger Distributionen wie K3s oder MicroK8s. Deployments, Services, ConfigMaps, Namespaces und Ingress-Ressourcen lassen sich grafisch verwalten. Für Einsteiger, die mit Kubernetes beginnen möchten, bietet Portainer einen sanfteren Einstieg als die reine Kommandozeile mit kubectl.

Vergleich: Docker-Management-Tools im Überblick

Tool GUI Docker Compose / Stacks Kubernetes Kostenlos
Portainer CE Web (vollständig) Ja (Stacks) Ja Ja
Yacht Web (einfach) Begrenzt Nein Ja
Dockge Web (Compose-fokussiert) Ja (Schwerpunkt) Nein Ja
Lazydocker Terminal-UI Teilweise Nein Ja

Typischer Homelab-Einsatz

Im Heimlabor läuft Portainer meist auf demselben Host wie die verwalteten Container – ein Raspberry Pi 4 oder ein Mini-PC mit Ubuntu. Portainer selbst verbraucht wenig Ressourcen (unter 100 MB RAM) und startet zuverlässig beim Systemstart dank --restart=always. In Verbindung mit einem Reverse-Proxy wie Nginx Proxy Manager – der ebenfalls als Stack in Portainer verwaltet werden kann – entsteht eine vollständige Heimserver-Infrastruktur, die komplett über den Browser administrierbar ist.

Fazit

Portainer CE ist das Standardwerkzeug für alle, die mehr als zwei oder drei Docker-Container betreiben. Die Kombination aus übersichtlichem Dashboard, Stack-Verwaltung, Multi-Umgebungs-Support und Kubernetes-Integration macht es zur umfassendsten kostenlosen Lösung in diesem Bereich. Wer ein Homelab betreibt oder Docker auf einem Server administriert, ohne ständig an der Kommandozeile arbeiten zu wollen, sollte Portainer zu seinem festen Werkzeugkasten zählen.

Häufig gestellte Fragen

Kann Portainer mehrere Server gleichzeitig verwalten?
Ja. Über den Portainer Agent oder die Docker-Remote-API lassen sich beliebig viele Umgebungen in einer Portainer-Instanz zusammenführen. Alle Hosts sind über das Dropdown-Menü in der Oberfläche erreichbar.
Was ist der Unterschied zwischen Portainer und Dockge?
Dockge ist ein neueres, leichtgewichtiges Tool, das sich ausschließlich auf Docker-Compose-Stacks konzentriert. Es hat eine modernere Oberfläche für diesen Zweck, bietet aber keine Kubernetes-Unterstützung, keine Multi-Host-Verwaltung und keinen direkten Container-Shell-Zugang. Portainer ist umfassender, Dockge schlanker.
Benötige ich Portainer, wenn ich bereits Kommandozeilenkenntnisse habe?
Nicht zwingend. Erfahrene Nutzer kommen auch gut mit reinem CLI aus. Portainer bietet aber echten Mehrwert durch visuelle Log-Ansicht, schnelle Übersichten über alle laufenden Container, Stack-Verwaltung und besonders beim Onboarding weiterer Personen, die Docker nicht vollständig beherrschen.
Ist Portainer auch für Produktionsumgebungen geeignet?
Portainer CE wird von vielen kleinen und mittelgroßen Teams produktiv eingesetzt. Für größere Unternehmen mit Compliance-Anforderungen, RBAC und Audit-Bedarf bietet die Business Edition die notwendigen Zusatzfunktionen. Grundsätzlich gilt: Portainer ergänzt die Container-Infrastruktur, ersetzt aber kein vollständiges CI/CD-System.