Setup-Assistent

Beim ersten Start erscheint automatisch der Setup-Bereich und führt dich durch alle Schritte, bis die Einrichtung abgeschlossen ist.

Voraussetzungen

Portainer Business Edition mit gültigem API-Key
Superuser-Zugangsdaten (entweder schon per Umgebungsvariablen gesetzt oder über diesen Assistenten festlegen)

Formularfelder Server-URL und optional Name ausfüllen.
- URL inkl. Protokoll (z. B. https://portainer.example.com).
- Bezeichnung dient ausschließlich als Anzeige im Dashboard.
Auf Verbindung testen klicken.
- Erfolgreich: grüner Hinweis, die Endpoints werden erkannt.
- Fehlgeschlagen: Fehlermeldung prüfen (häufig Zertifikats-/Firewall-Themen).
Mit Speichern & Weiter bestätigst du den Servereintrag. StackPulse legt ihn verschlüsselt in SQLite ab.

API-Key im Feld Portainer API Key einfügen.
Optional kannst du über Stacks laden kontrollieren, ob Portainer Stacks zurückliefert.
Mit Speichern wird der Schlüssel verschlüsselt gespeichert. Du kannst ihn später im Maintenance-Bereich austauschen.

Falls du SUPERUSER_* Variablen gesetzt hast, zeigt StackPulse an, dass bereits ein Superuser existiert – du kannst direkt weiter.
Ansonsten Benutzername, E-Mail und Passwort vergeben. Das Passwort dient nur für diesen Account; weitere Benutzer folgen später.
Auf Superuser anlegen klicken. Nach Erfolg wird der Login-Button eingeblendet.

Sobald alle drei Schritte abgeschlossen sind, erscheint die Schaltfläche Zum Login.
Melde dich mit dem Superuser an. StackPulse legt im Hintergrund initiale Berechtigungen, Default-Gruppen und Sicherheitspassphrasen an.

Über das Dashboard → Wartung → Abschnitt Serververwaltung kannst du zusätzliche Portainer-Server hinzufügen oder entfernen.
Superuser lässt sich im Bereich Benutzer löschen, sofern du das Recht Superuser löschen besitzt.
Der Self-Stack (StackPulse-eigener Stack) kann in der Wartung gepflegt werden, damit er nicht versehentlich redeployed wird.