Portainer Agent mit dem Portainer-Server verbinden
Schritt-fuer-Schritt-Anleitung, wie du einen Docker-Host ueber den Portainer Agent (Port 9001) als Environment im Portainer-Server einbindest und seine Container zentral verwaltest.
Wenn du Docker-Container auf mehreren Geraeten betreibst, willst du sie meist nicht einzeln, sondern zentral verwalten. Genau dafuer gibt es den Portainer Agent: Er laeuft als Container auf einem entfernten Docker-Host und macht diesen ueber einen einzigen Port fuer den Portainer-Server erreichbar. In dieser Anleitung verbindest du einen solchen Host als Environment mit deinem Portainer-Server und kannst danach alle seine Container von einer Oberflaeche aus steuern.
Voraussetzung: Auf dem entfernten Docker-Host laeuft bereits der Portainer-Agent-Container und lauscht auf Port 9001. Der Portainer-Server muss diesen Host ueber das Netzwerk erreichen koennen.
Agent als neues Environment hinzufuegen
Schritt 1. Oeffne den Portainer-Server im Browser und melde dich mit deinen Zugangsdaten an. Klicke anschliessend in der linken Seitenleiste auf «Environments» und oben rechts auf «Add Environment».
Schritt 2. Waehle die Variante «Docker Standalone» aus und klicke auf «Start Wizard», um den Einrichtungsassistenten zu starten.
Schritt 3. Waehle als Verbindungsart «Agent» und vergib einen Namen fuer das Geraet. Trage danach die IP-Adresse des Docker-Hosts sowie den Port 9001 ein und klicke auf «Connect». Der Agent sollte sich nun erfolgreich mit dem Portainer-Server verbinden.
Nach erfolgreicher Verbindung erscheint das Geraet unter der Rubrik «New Environments». Wird es dort aufgelistet, ist die Einrichtung abgeschlossen und du kannst die Container des Hosts ab sofort ueber den Portainer-Server verwalten.
Verbundene Environments aufrufen und Container verwalten
Schritt 4. Klicke auf den Home-Button, um zur Portainer-Startseite zurueckzukehren. Dort werden alle Environments aufgelistet, die mit dem Portainer-Server verbunden sind.
Schritt 5. Waehle ein Environment aus, indem du auf den entsprechenden Namen klickst. Du gelangst zur Uebersichtsseite, auf der alle Docker-Container und Services des jeweiligen Geraets aufgelistet sind.
Von hier aus verwaltest du die Container des Hosts direkt: neue Container erstellen, vorhandene starten, stoppen oder entfernen sowie die Container-Logs einsehen.
Fazit
Mit dem Portainer Agent bindest du beliebige Docker-Hosts ueber einen einzigen Port (9001) als Environment in deinen Portainer-Server ein. So verwaltest du Container verteilter Geraete bequem an einer zentralen Stelle, statt dich auf jedem Host einzeln anzumelden.
// Teste dich
Wozu dient der Portainer Agent?
Hat dir diese Anleitung geholfen?
// Wie es weitergeht
Portainer
Portainer ist die Web-Oberfläche für Docker: Container, Stacks und ganze Geräteflotten per Klick statt Kommandozeile.
Der Stack Baukasten: Docker Stacks ohne YAML zusammenklicken
Ein kostenloses Werkzeug auf iotueli.ch, mit dem du komplette Docker Stacks per Mausklick zusammenstellst und als fertige compose.yml herunterlädst. Diese Anleitung zeigt Schritt für Schritt, wie es geht.
n8n mit Docker installieren: Workflows selbst gehostet automatisieren
n8n ist ein quelloffenes Low-Code-Tool zur Workflow-Automatisierung. Es verbindet Geräte, APIs und Dienste über visuelle Knoten und eignet sich ideal, um IoT-Daten, Webhooks und Aktionen ohne viel Code zu orchestrieren.
Docker installieren unter Linux: Schritt-für-Schritt-Anleitung
Docker auf einem Linux-Server einrichten — vom schnellen Convenience-Skript bis zum sauberen apt-Repository, inkl. „ohne sudo" und Test.