Umfassende Anleitung: So installieren Sie Portainer unter Ubuntu 22.04 und verwalten Docker ganz einfach

Portainer hat sich zu einer der effizientesten und benutzerfreundlichsten Methoden zur Verwaltung von Docker-Umgebungen entwickelt. Anstatt sich lange Befehlszeilenbefehle merken zu müssen, können Sie Container, Images, Volumes und Netzwerke über eine übersichtliche Weboberfläche verwalten.

In dieser ausführlichen Anleitung erfahren Sie, wie Sie Portainer unter Ubuntu 22.04 installieren, korrekt konfigurieren und mit der visuellen Verwaltung von Docker-Containern beginnen.

Warum Portainer anstelle der Docker-CLI verwenden

Die Docker-CLI ist ein robustes Tool, mit dem Entwickler alles von der Containererstellung bis zur Netzwerkverwaltung abwickeln können. Es ist schnell und flexibel, jedoch vollständig textbasiert, was für Anfänger verwirrend und für fortgeschrittene Benutzer, die in großen Umgebungen arbeiten, repetitiv sein kann.

Portainer bietet eine intuitive grafische Oberfläche auf Basis von Docker. Es beseitigt unnötige Komplexität und hilft Teams, den Status ihrer Container in Echtzeit zu visualisieren. Mit Portainer können Sie Images schnell bereitstellen, die Leistung überwachen und Protokolle überprüfen, ohne mehrere Befehle eingeben zu müssen.

Aus diesem Grund entscheiden sich viele Administratoren dafür, Portainer auf Ubuntu zu installieren, um die tägliche Containerverwaltung zu vereinfachen und gleichzeitig die vollständige Kontrolle über ihre Docker-Infrastruktur zu behalten.

Was ist Portainer und warum ist es wichtig

Portainer ist eine Open-Source-Plattform, die als schlanke Verwaltungsschicht für Docker, Docker Swarm und Kubernetes fungiert. Sie läuft selbst als Docker-Container und bietet über ein Web-Dashboard Zugriff auf alle containerbezogenen Ressourcen.

Portainer ersetzt Docker nicht, sondern erweitert es. Nach Abschluss der Installation von Portainer über Docker erhalten Sie die Möglichkeit, Ihre Container, Netzwerke und Volumes visuell zu verwalten. Dies ist besonders nützlich für Systemadministratoren, DevOps-Ingenieure und Entwickler, die es vorziehen, in einer übersichtlichen Oberfläche zu arbeiten.

Verfügbare Versionen von Portainer

Es gibt zwei Hauptversionen von Portainer:

• Community Edition (CE) – Kostenlos und Open Source, ideal für private oder kleine Unternehmensprojekte.
• Business Edition (BE) – Kostenpflichtige Version mit erweiterten Funktionen wie rollenbasierter Zugriffskontrolle, Verwaltung externer Registries und Verbindungen zu mehreren Umgebungen.

Wenn Sie lediglich grundlegende Containerverwaltung benötigen, wird die Community Edition Ihre Anforderungen voll und ganz erfüllen, wenn Sie Portainer auf Ubuntu 22.04 installieren.

Die wichtigsten Vorteile der Verwendung von Portainer

Sobald Sie die Installation von Portainer auf Ubuntu abgeschlossen haben, profitieren Sie von mehreren praktischen Vorteilen:

• Verwalten Sie Container und Images über eine intuitive Weboberfläche.
• Stellen Sie Stacks aus Docker-Compose-Dateien direkt in Ihrem Browser bereit.
• Überwachen Sie die Systemleistung und Container-Protokolle.
• Verbinden und verwalten Sie entfernte Docker-Knoten oder Kubernetes-Cluster.
• Vereinfachen Sie die Netzwerk- und Volume-Konfiguration.

Diese Kombination aus Komfort und Kontrolle macht Portainer zu einem der besten GUI-Tools für das Container-Management.

Was benötigen Sie, bevor Sie beginnen?

Bevor Sie die Installationsschritte befolgen, stellen Sie sicher, dass Sie Folgendes haben:

1. Ein System mit Ubuntu 22.04.
2. Einen Benutzer mit sudo-Rechten.
3. Eine aktive Internetverbindung zum Herunterladen der Docker- und Portainer-Images.

Sobald diese Voraussetzungen erfüllt sind, können Sie mit der Einrichtung beginnen.

Schritt 1: Aktualisieren Sie die Systempakete

Die Aktualisierung Ihres Systems ist der erste Schritt bei jeder Installation. Führen Sie den folgenden Befehl aus:

sudo apt update && sudo apt upgrade -y

Dadurch wird die Paketliste aktualisiert und sichergestellt, dass Ihr System für die neuesten Docker- und Portainer-Versionen bereit ist.

Schritt 2: Docker Engine installieren

Da Portainer selbst als Docker-Container läuft, muss Docker zuerst installiert werden. Um Docker aus den Ubuntu-Repositorys zu installieren, führen Sie Folgendes aus:

sudo apt install docker.io -y

Nach der Installation aktivieren und starten Sie den Docker-Dienst:

sudo systemctl enable docker

sudo systemctl start docker

Überprüfen Sie, ob Docker ordnungsgemäß läuft:

sudo systemctl status docker

Wenn alles korrekt ist, wird der Status als „active (running)“ angezeigt.

Fügen Sie Ihren Benutzer zur Docker-Gruppe hinzu, damit Sie Docker-Befehle verwenden können, ohne jedes Mal „sudo“ eingeben zu müssen:

sudo usermod -aG docker $USER

Öffnen Sie eine neue Terminalsitzung, um die Änderungen zu übernehmen. Ihre Docker-Umgebung für die Portainer-Installation ist nun bereit.

Schritt 3: Portainer auf Ubuntu installieren

Um Portainer auf Ubuntu zu installieren, laden Sie das neueste Portainer-Image von Docker Hub herunter:

docker pull portainer/portainer-ce:latest

Überprüfen Sie nach dem Herunterladen, ob das Image verfügbar ist:

docker images

Führen Sie anschließend den Portainer-Container aus:

docker run -d -p 9000:9000 \

--name portainer \

--restart always \

-v /var/run/docker.sock:/var/run/docker.sock \

-v portainer_data:/data \

portainer/portainer-ce:latest

Erläuterung der Optionen:

• -d führt den Container im detachierten Modus aus.
• -p 9000:9000 ordnet den Port des Containers dem Port Ihres Servers zu.
• --restart always sorgt dafür, dass der Container nach einem Neustart weiterläuft.
• -v bindet Volumes für persistente Daten ein.

Um zu überprüfen, ob Portainer läuft, verwenden Sie:

docker ps

Sie sollten sehen, dass der Portainer-Container aktiv ist und dem Port 9000 zugeordnet ist.

Schritt 4: Auf das Portainer-Web-Dashboard zugreifen

Sobald Portainer läuft, öffnen Sie Ihren Browser und rufen Sie folgende Adresse auf:

http://your-server-ip:9000

Sie werden aufgefordert, ein Administratorkonto zu erstellen. Geben Sie einen Benutzernamen und ein sicheres Passwort ein und klicken Sie dann auf „Create User“.

Danach gelangen Sie zum Bildschirm „Connect to Environment“. Wählen Sie die Option „Local environment“ und klicken Sie auf „Connect“. Portainer erkennt den Docker-Daemon auf Ihrem System automatisch und stellt eine Verbindung zu ihm her.

Nun können Sie alle Docker-Ressourcen direkt über Ihre Weboberfläche verwalten.

Schritt 5: Stellen Sie Ihren ersten Container über Portainer bereit

Wählen Sie im Portainer-Dashboard „Containers“ → „Add container“ aus.

Geben Sie den Containernamen, den Image-Namen (z. B. nginx:latest) und die Portzuordnung (80:80) ein.

Klicken Sie auf „Deploy the container“, um den Container zu starten.

Innerhalb weniger Sekunden erscheint der neue Container in Ihrer Liste, läuft und ist zugänglich.

Über das Dashboard können Sie ganz einfach:

• Container starten, stoppen, neu starten oder löschen.
• Protokolle anzeigen und die Ressourcennutzung überprüfen.
• Netzwerke oder Volumes visuell erstellen.
• Neue Images von Docker Hub abrufen.

Dieser Schritt verdeutlicht den praktischen Nutzen der Portainer-Installation unter Ubuntu.

Schritt 6: Sichern der Portainer-Installation

Standardmäßig läuft Portainer über HTTP. Für den Produktionsbetrieb wird dringend empfohlen, den Zugriff über HTTPS zu sichern. Sie können einen Reverse-Proxy wie Nginx verwenden:

sudo apt install nginx -y

Konfigurieren Sie Nginx so, dass HTTPS-Anfragen an Portainer-Port 9000 weitergeleitet werden.

Alternativ können Sie SSL-Zertifikate mithilfe von Volume-Parametern direkt in den Portainer-Container einbinden. Dies gewährleistet einen verschlüsselten Zugriff für alle Benutzer.

Schritt 7: Portainer aktualisieren oder neu installieren

Um Portainer auf dem neuesten Stand zu halten, laden Sie die aktuellste Version herunter und erstellen Sie den Container neu:

docker pull portainer/portainer-ce:latest

docker stop portainer

docker rm portainer

Starten Sie den Container anschließend erneut mit demselben Befehl aus Schritt 3.

Ihre Konfiguration und Ihre Benutzer bleiben erhalten, da sie im Volume „portainer_data“ gespeichert sind.

Sollten Sie jemals eine saubere Neuinstallation durchführen müssen, entfernen Sie einfach dieses Volume vor der erneuten Bereitstellung.

Schritt 8: Behebung häufiger Probleme

Wenn Portainer nicht geladen wird oder einen Timeout-Fehler anzeigt, starten Sie den Container neu:

docker restart portainer

Falls Docker selbst nicht mehr reagiert:

sudo systemctl restart docker

Überprüfen Sie außerdem Ihre Firewall und stellen Sie sicher, dass Port 9000 offen ist:

sudo ufw allow 9000/tcp

Diese Schritte beheben 90 % der Zugriffs- und Startprobleme bei der Installation von Portainer unter Ubuntu.

Schritt 9: Automatisieren Sie den Installationsprozess

Für DevOps-Teams, die mehrere Server verwalten, spart die Automatisierung der Docker-Installation von Portainer Zeit.

Erstellen Sie ein Shell-Skript:

#!/bin/bash

sudo apt update -y

sudo apt install docker.io -y

sudo systemctl enable docker --now

docker pull portainer/portainer-ce:latest

docker run -d -p 9000:9000 --restart always \

-v /var/run/docker.sock:/var/run/docker.sock \

-v portainer_data:/data portainer/portainer-ce:latest

Speichern Sie es als install_portainer.sh, machen Sie es mit chmod +x install_portainer.sh ausführbar und führen Sie es auf jeder neuen Ubuntu-Instanz aus, um die Bereitstellung zu automatisieren.

Schritt 10: Portainer mit Kubernetes oder Swarm verbinden

Nachdem Sie die Installation von Portainer auf Ubuntu abgeschlossen haben, können Sie es mit Kubernetes oder Docker Swarm verbinden.

Über das Portainer-Dashboard können Sie Cluster visualisieren, Stacks bereitstellen, Pods verwalten und Konfigurationen in Echtzeit anwenden.

Diese umgebungsübergreifende Funktionalität macht Portainer zu einer einheitlichen Plattform für die Verwaltung hybrider Container-Ökosysteme, ohne dass mehrere Tools installiert werden müssen.

Schritt 11: Portainer-Daten sichern und wiederherstellen

Portainer speichert seine Daten im Volume „portainer_data“.

So erstellen Sie ein Backup:

docker stop portainer

docker run --rm -v portainer_data:/data -v $(pwd):/backup busybox tar czf /backup/portainer_backup.tar.gz /data

So stellen Sie die Daten aus dem Backup wieder her:

docker run --rm -v portainer_data:/data -v $(pwd):/backup busybox tar xzf /backup/portainer_backup.tar.gz -C /

Durch regelmäßige Backups stellen Sie sicher, dass Sie Konfigurationen nach Updates oder Migrationen schnell wiederherstellen können.

Schritt 12: Überprüfen Sie die Installation

Führen Sie den folgenden Befehl aus:

docker ps

Sie sollten sehen, dass Portainer läuft und dem Port 9000 zugeordnet ist.

Öffnen Sie Ihren Browser unter http://your-server-ip:9000 und melden Sie sich an, um zu überprüfen, ob das Dashboard erreichbar ist und Ihre Container korrekt anzeigt.

Zusätzliche Tipps für stabile Leistung

Diese Best Practices helfen dabei, eine saubere und zuverlässige Container-Verwaltungsumgebung aufrechtzuerhalten:

1. Benutzerdefinierte Portzuordnung: Verwenden Sie -p 8080:9000, falls Port 9000 bereits belegt ist.
2. Persistenter Speicher: Definieren Sie zur Datenspeicherung stets benannte Volumes.
3. Ressourcenverwaltung: Begrenzen Sie die CPU- und Speicherauslastung für jeden Container.
4. Regelmäßige Updates: Laden Sie monatlich neue Portainer-Images herunter, um die Sicherheit zu gewährleisten.

Fazit: Die wahre Stärke der Portainer-Installation unter Ubuntu

Wenn Sie die Anleitung zur Installation von Portainer unter Ubuntu erfolgreich abschließen, erhalten Sie eine grafische, sichere und skalierbare Möglichkeit zur Verwaltung von Containern. Portainer ist nicht nur ein visueller Ersatz für die Docker-CLI, sondern eine strategische Ebene, die die Orchestrierung vereinfacht, die Transparenz erhöht und den Betrieb über mehrere Umgebungen hinweg beschleunigt.

Durch die Integration von Portainer mit Docker und Kubernetes können Sie komplexe Infrastrukturen mit minimalem Aufwand verwalten. Die übersichtliche Benutzeroberfläche verkürzt die Einarbeitungszeit für Einsteiger und bietet gleichzeitig Experten erweiterte Kontrollmöglichkeiten.

Für Teams, die Microservices, CI/CD-Pipelines oder Testumgebungen verwalten, gewährleistet Portainer Stabilität und Transparenz auf jeder Ebene.

Wenn Sie Portainer unter Ubuntu installieren, schaffen Sie eine solide Grundlage für automatisiertes Container-Management. Es überbrückt die Kluft zwischen Entwicklern und Systemadministratoren und fördert die Zusammenarbeit durch eine benutzerfreundliche Oberfläche.

Portainer zu beherrschen bedeutet, Transparenz, Governance und Konsistenz in modernen Cloud-nativen Ökosystemen zu beherrschen. Deshalb ist die Installation von Portainer unter Ubuntu mehr als nur ein technischer Schritt; sie ist ein Meilenstein auf dem Weg zu einem effizienten und intelligenten Infrastrukturmanagement.