Portainer Server mit Docker installieren
Schritt-für-Schritt-Anleitung zur Installation einer Portainer-Server-Instanz auf einem Linux-Host mit Docker – inklusive Container-Start, Prüfung und Erstkonfiguration der Weboberfläche.
Portainer ist eine grafische Oberfläche zur Verwaltung von Docker-Umgebungen. In dieser Anleitung installierst du eine Portainer-Server-Instanz als Container direkt auf einem Linux-Host. Voraussetzung ist, dass die Docker-Engine bereits installiert und einsatzbereit ist.
Diese Anleitung verwendet das Image portainer/portainer-ee (Business Edition). Die Business Edition lässt sich kostenlos nutzen, ist in der freien Variante aber auf die Verwaltung von 5 Portainer-Agents begrenzt. Für Tests und die meisten privaten Setups reicht das aus. Wer stattdessen die Community Edition bevorzugt, kann das Image durch portainer/portainer-ce ersetzen.
Schritt 1: Portainer-Container starten
Schritt 1. Führe den folgenden Befehl auf dem Hostsystem aus, auf dem die Portainer-Server-Instanz laufen soll. Er lädt das Image herunter und startet den Container.
1sudo docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always \2 -v /var/run/docker.sock:/var/run/docker.sock \3 -v portainer_data:/data \4 portainer/portainer-ee:latest
Die Optionen im Überblick: -d startet den Container im Hintergrund, -p 8000:8000 und -p 9443:9443 veröffentlichen die benötigten Ports (8000 für die Agent-Kommunikation, 9443 für die HTTPS-Weboberfläche), --restart=always sorgt für einen automatischen Neustart, und über die beiden -v-Optionen werden der Docker-Socket sowie ein persistentes Daten-Volume eingebunden.
Schritt 2: Container-Status prüfen
Schritt 2. Nachdem das Image heruntergeladen und der Container gestartet wurde, kannst du mit folgendem Befehl prüfen, ob der Container ordnungsgemäß läuft:
1sudo docker ps
In der Ausgabe sollte der Container portainer als laufend aufgeführt sein. Erscheint er nicht, lohnt ein Blick in die Logs mit sudo docker logs portainer.
Schritt 3: Weboberfläche öffnen und Admin-Konto anlegen
Schritt 3. Öffne die Portainer-Weboberfläche im Browser über die folgende Adresse, wobei du ip-adresse durch die IP-Adresse oder den Hostnamen deines Hosts ersetzt:
1https://ip-adresse:9443
Es öffnet sich die Einrichtungsseite von Portainer. Lege dort den ersten Administratorbenutzer mit einem sicheren Passwort an. Nach der Anmeldung kannst du weitere Benutzer mit unterschiedlichen Rollen und Rechten anlegen.
Beim Einsatz der Business Edition wird beim ersten Start nach einem Lizenzschlüssel gefragt. Diesen erhältst du nach kostenloser Registrierung bei Portainer und trägst ihn anschließend in der Oberfläche ein.
Fazit
Damit ist die Portainer-Server-Instanz installiert und über die Weboberfläche erreichbar. Von hier aus lassen sich Container, Images, Volumes und Netzwerke komfortabel verwalten sowie weitere Hosts über Portainer-Agents anbinden. Portainer ist ein vielseitiges Werkzeug – nimm dir Zeit, die Oberfläche kennenzulernen.