TL;DR: Portainer ist ein leistungsstarkes, webbasiertes Management-Tool für Docker-Container. Diese Anleitung zeigt dir Schritt für Schritt, wie du Portainer auf einem Linux-Server installierst und für professionelles Container-Management nutzt.
Was ist Portainer?
Portainer ist eine benutzerfreundliche, webbasierte Verwaltungsoberfläche für Docker-Umgebungen. Es ermöglicht Entwicklern und Systemadministratoren eine einfache Verwaltung von:
- Docker-Containern
- Docker-Images
- Netzwerken
- Volumes
- Stacks und Compose-Dateien
Mit Portainer kannst du deine gesamte Container-Infrastruktur zentral und intuitiv verwalten, ohne komplexe Kommandozeilen-Befehle lernen zu müssen.
Inhaltsverzeichnis:
- Voraussetzungen
- Docker Installation
- Portainer Installation
- Erstes Setup
- Sicherheit
- Troubleshooting
- FAQ
Voraussetzungen
Hardware-Anforderungen
- Mindestens 1 CPU-Kern
- Mindestens 2 GB RAM
- Mindestens 20 GB Speicherplatz (SSD empfohlen)
- 64-bit Linux-System
Software-Voraussetzungen
- Linux-Betriebssystem in einer aktuellen, noch unterstützten Version:
- Debian
- Ubuntu
- Rocky Linux oder AlmaLinux
- Root- oder Sudo-Zugriff
- Aktive Internetverbindung
- SSH-Client (Termius empfohlen)
1. Docker Installation
Portainer läuft selbst als Container, deshalb brauchst du zuerst Docker. Ausführliche Erklärungen zu jedem Schritt findest du in meiner Anleitung Docker auf Linux installieren. Hier die Kurzfassung über die offizielle Paketquelle von Docker.
Debian/Ubuntu Installation
# System aktualisierensudo apt updatesudo apt upgrade -y # Benötigte Pakete installierensudo apt install -y ca-certificates curl # Docker GPG-Schlüssel hinzufügen (unter Ubuntu: linux/ubuntu statt linux/debian)sudo install -m 0755 -d /etc/apt/keyringssudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.ascsudo chmod a+r /etc/apt/keyrings/docker.asc # Docker Repository einrichten (unter Ubuntu: linux/ubuntu statt linux/debian)echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # Docker installierensudo apt updatesudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # Docker-Dienst starten und aktivierensudo systemctl enable --now docker # Aktuellen Benutzer zur Docker-Gruppe hinzufügen (danach einmal ab- und wieder anmelden)sudo usermod -aG docker $USERRocky Linux/AlmaLinux Installation
# System aktualisierensudo dnf update -y # Plugin für config-manager installieren und Docker-Repository hinzufügensudo dnf install -y dnf-plugins-coresudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # Docker installierensudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # Docker-Dienst starten und aktivierensudo systemctl enable --now docker # Aktuellen Benutzer zur Docker-Gruppe hinzufügen (danach einmal ab- und wieder anmelden)sudo usermod -aG docker $USERBeachte: Mitglieder der Gruppe docker haben faktisch Root-Rechte auf dem Server. Nimm dort nur Benutzer auf, denen du entsprechend vertraust.
2. Portainer Installation
Docker Volume erstellen
docker volume create portainer_dataPortainer Container starten
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:latest3. Erstes Setup und Konfiguration
- Öffne in deinem Browser:
https://DEINE_SERVER_IP:9443 - Bestätige die Warnung zum selbstsignierten Zertifikat
- Erstelle einen Admin-Benutzer
- Starkes Passwort verwenden
- Mindestens 12 Zeichen
- Kombination aus Groß-/Kleinbuchstaben, Zahlen und Sonderzeichen
Wichtig: Lege das Admin-Konto direkt nach dem ersten Start an. Aus Sicherheitsgründen schließt Portainer die Ersteinrichtung nach wenigen Minuten. Ist das passiert, startest du den Container mit docker restart portainer neu und rufst die Seite erneut auf.
4. Sicherheitshinweise
- Aktiviere Zwei-Faktor-Authentifizierung
- Beschränke Portainer-Zugriff über Firewall
- Verwende SSH-Schlüssel statt Passwörter
- Halte Docker und Portainer aktuell
Firewall-Konfiguration
# UFW (Ubuntu)sudo ufw allow 9443/tcp # FirewallD (CentOS/Rocky)sudo firewall-cmd --permanent --add-port=9443/tcpsudo firewall-cmd --reloadTroubleshooting
Häufige Probleme
-
Container startet nicht
- Docker-Installation überprüfen
- Systemlogs prüfen:
journalctl -u docker.service
-
Keine Verbindung möglich
- Firewall-Einstellungen kontrollieren
- Port-Freigaben überprüfen
- Docker-Dienst neu starten:
sudo systemctl restart docker
Häufig gestellte Fragen (FAQ)
Ist Portainer kostenlos?
Ja, Portainer Community Edition ist komplett kostenlos und Open Source.
Welche Docker-Umgebungen unterstützt Portainer?
- Docker Standalone
- Docker Swarm
- Kubernetes (mit Einschränkungen in CE)
Kann ich mehrere Docker-Hosts verwalten?
Ja, auch mit der kostenlosen Community Edition. Weitere Server bindest du über den Portainer Agent oder den Edge Agent als zusätzliche Umgebung ein. Die kostenpflichtige Business Edition ergänzt vor allem Funktionen für Teams und Unternehmen, etwa eine feinere Rechteverwaltung.
Zusätzliche Ressourcen
Fazit
Portainer vereinfacht die Docker-Container-Verwaltung erheblich. Mit dieser Anleitung hast du nun eine leistungsstarke, webbasierte Administrationsoberfläche für deine Container-Infrastruktur. Möchtest du nicht nur Container, sondern den ganzen Server im Browser verwalten, passt Cockpit für die Linux-Serververwaltung gut dazu. Und wenn du Anwendungen direkt aus einem Git-Repository deployen willst, schau dir an, wie du Coolify installierst.
Vorteile auf einen Blick:
- Einfache Installation
- Benutzerfreundliche Weboberfläche
- Hohe Sicherheitsstandards
- Kostenlos für Einzelserver
Viel Erfolg mit deiner Portainer-Installation! Bei Fragen oder Problemen hinterlasse gerne einen Kommentar.