Portainer installieren: Docker per Weboberfläche verwalten

Docker ausschließlich über die Kommandozeile zu bedienen, ist mächtig – aber nicht immer bequem. Mit Portainer bekommst du eine übersichtliche Weboberfläche für all deine Container, Images, Volumes und Netzwerke. In dieser Anleitung zeigen wir dir, wie du Portainer installierst und Docker per Weboberfläche verwaltest – von der Installation über die Ersteinrichtung bis zu Stacks und Updates.

Docker über die Kommandozeile zu bedienen ist mächtig, aber nicht immer bequem – gerade wenn du mehrere Container, Volumes und Netzwerke im Blick behalten willst. Portainer bringt eine grafische Weboberfläche mit, über die du Container starten, stoppen, Logs einsehen und Images verwalten kannst, ganz ohne lange Befehle. In dieser Anleitung installierst du Portainer als Container, sicherst den Zugang ab und erfährst, für welche Aufgaben sich das Web-UI wirklich lohnt.

Was ist Portainer?

Portainer ist ein leichtgewichtiges Management-Tool für Docker. Es läuft selbst als Container und stellt eine grafische Oberfläche bereit, über die du deine gesamte Docker-Umgebung im Browser steuerst: Container starten und stoppen, Logs einsehen, Images verwalten, Volumes und Netzwerke anlegen. Gerade für den Einstieg oder zum schnellen Überblick ist das Gold wert.

Voraussetzungen

• Eine laufende Docker-Installation. Wie du zusätzlich Compose einrichtest, steht in Docker Compose installieren.
• Ein freier Port für die Weboberfläche (standardmäßig 9443 für HTTPS).
• Root- bzw. sudo-Rechte auf dem Host.

Portainer per Docker Compose installieren

Am saubersten installierst du Portainer über Compose. Lege eine docker-compose.yml mit folgendem Inhalt an:

services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: unless-stopped
    ports:
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:

services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: unless-stopped
    ports:
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:

Starte den Stack anschließend:

docker compose up -d

docker compose up -d

Zwei Dinge sind hier zentral: Der Mount von /var/run/docker.sock gibt Portainer Zugriff auf die Docker Engine. Und das Named Volume portainer_data speichert deine Einstellungen dauerhaft – mehr dazu in Docker Volumes.

Erste Einrichtung

Öffne nun im Browser https://SERVER-IP:9443. Da Portainer ein selbstsigniertes Zertifikat nutzt, musst du die Sicherheitswarnung einmalig bestätigen. Beim ersten Aufruf legst du einen Admin-Benutzer mit sicherem Passwort an.

Wichtig: Erledige das zügig. Aus Sicherheitsgründen sperrt Portainer die Ersteinrichtung, wenn der Container zu lange ohne angelegten Admin läuft. Passiert das, starte den Container einfach neu.

Was du mit Portainer machen kannst

Nach dem Login wählst du die lokale Umgebung aus und hast Zugriff auf:

• Container: starten, stoppen, neu starten, Logs und Statistiken einsehen, in eine Konsole springen.
• Images: herunterladen, ansehen und ungenutzte entfernen.
• Volumes & Netzwerke: anlegen und verwalten – die Theorie dazu liefert Docker Netzwerke erklärt.
• Stacks: komplette Compose-Setups direkt in der Oberfläche bereitstellen.

Stacks: Compose in der Weboberfläche

Das Highlight sind die Stacks. Ein Stack ist nichts anderes als eine docker-compose.yml, die du direkt in Portainer einfügst und startest. So verwaltest du Multi-Container-Anwendungen bequem im Browser, ohne dich per SSH einzuloggen. Änderungen an der YAML lassen sich direkt in der Oberfläche vornehmen und neu ausrollen.

Portainer aktualisieren

Ein Update ist unkompliziert: neues Image ziehen und den Container neu erstellen. Im Compose-Verzeichnis genügt:

docker compose pull
docker compose up -d

docker compose pull
docker compose up -d

Weil deine Daten im Volume portainer_data liegen, bleiben alle Einstellungen erhalten. Diesen Vorgang kannst du auch von Watchtower automatisieren lassen.

Portainer CE oder Business Edition?

Portainer gibt es in zwei Varianten. Für private Server und die meisten Homelabs reicht die kostenlose Community Edition (CE) vollständig aus. Die Business Edition richtet sich an Teams und bietet Funktionen wie feingranulare Rollen und RBAC, die im Einzelbetrieb keinen Mehrwert bringen.

Zugriff absichern

Portainer hat weitreichende Kontrolle über deinen Docker-Host – wer sich einloggt, kann Container starten und stoppen. Deshalb solltest du den Zugang niemals ungeschützt ins Internet stellen. Vergib beim ersten Start ein starkes Admin-Passwort und stelle Portainer im Idealfall nur über einen Reverse-Proxy mit HTTPS bereit.

• Erreiche Portainer nur im lokalen Netz oder über ein VPN wie WireGuard.
• Setze einen Reverse-Proxy (z. B. Nginx oder Traefik) mit TLS-Zertifikat davor.
• Aktiviere die automatische Abmeldung nach Inaktivität in den Einstellungen.

Wann sich Portainer lohnt – und wann nicht

Portainer ist ideal, wenn du den Überblick über viele Container behalten oder Kollegen ohne Terminal-Kenntnisse einen kontrollierten Zugriff geben willst. Für die schnelle Statusabfrage bleibt docker ps auf der Kommandozeile trotzdem oft schneller. Sieh die Weboberfläche als Ergänzung, nicht als vollständigen Ersatz für die CLI.

Ein praktischer Vorteil: Über die Stack-Funktion kannst du komplette docker-compose.yml-Dateien direkt im Browser einfügen und deployen. Änderungen an Umgebungsvariablen oder Ports erledigst du so ohne SSH-Sitzung. Behalte dabei im Hinterkopf, dass Portainer selbst ein Container ist und regelmäßige Updates braucht: Nur eine aktuelle Version schließt bekannte Sicherheitslücken. Und weil das Web-UI über den Docker-Socket weitreichende Rechte am Host besitzt, ist ein kompromittierter Portainer-Zugang faktisch gleichbedeutend mit vollem Zugriff auf den Server – ein weiterer Grund, den Zugang konsequent hinter VPN oder Reverse-Proxy zu verstecken.

Praktisch im Alltag: Über das Dashboard spürst du verwaiste Images und ungenutzte Volumes auf, die still Speicherplatz belegen, und entfernst sie mit wenigen Klicks. Für Einsteiger senkt Portainer damit die Hürde spürbar – du siehst auf einen Blick, welche Container laufen, wie viel Speicher sie verbrauchen und wo Handlungsbedarf besteht, ohne dir dafür Dutzende CLI-Befehle merken zu müssen.

Häufige Fragen

Die wichtigsten Fragen rund um Installation und Betrieb von Portainer.

Verliere ich meine Container, wenn ich Portainer entferne?

Nein. Portainer ist nur eine Verwaltungsschicht. Entfernst du den Portainer-Container, laufen deine anderen Container unverändert weiter, weil sie direkt vom Docker-Daemon verwaltet werden.

Wie aktualisiere ich Portainer?

Du stoppst und löschst den alten Container, ziehst das neue Image mit docker pull portainer/portainer-ce:latest und startest ihn mit demselben Volume erneut. Deine Einstellungen bleiben im Volume erhalten.

Kann Portainer mehrere Docker-Hosts verwalten?

Ja, über sogenannte Environments oder den Portainer-Agent lassen sich mehrere Hosts und sogar Kubernetes-Cluster aus einer Oberfläche steuern.

Fazit

Portainer macht Docker zugänglich: Statt langer Befehle verwaltest du deine Container komfortabel im Browser – inklusive Logs, Stacks und einem klaren Überblick über die ganze Umgebung. Für den produktiven Einsatz solltest du die Oberfläche nicht ungeschützt ins Internet stellen, sondern hinter einen Reverse Proxy wie den Nginx Proxy Manager setzen.