Zum Hauptinhalt springen

Passwort · API-Schlüssel ändern

Die vom Studio verwendeten DB-Konten und AI-Schlüssel haben bei allen Installationen den gleichen Anfangswert. Bei der Inbetriebnahme einmal ändern und damit ist es erledigt. Danach gibt es keinen Handlungsbedarf mehr.

Das Werkzeug zum Ändern ist genau eines: bin/passwd.sh. Die drei Produkte platform · ai · studio haben es mit gleichem Namen, gleicher Bedienung.

Die maßgebliche Konfiguration ist /etc/kopens/plantpulse-studio.env

Das Geheimnis dieses Produkts liegt in /etc/kopens/plantpulse-studio.env. Nicht im Installationsverzeichnis (/opt/kopens/plantpulse-studio-docker), sondern außerhalb des Repo-Baums, und die Berechtigung ist 0600.

Die .env im Installationsverzeichnis ist der alte Pfad. Heute liest sie niemand mehr — Änderungen dort ändern den Stack nicht.

Vor dem 16.08.2026 schrieb passwd.sh in /etc/kopens/plantpulse-studio.env, während Compose und die übrigen Skripte die .env im Repo-Root lasen. Dadurch war die Rotation stillschweigend wirkungslos, und passwd.sh meldete Erfolg, während der Stack mit den alten Werten weiterlief (so war es bei PS_ANTHROPIC_API_KEY · PI_LLM_API_KEY). Schreiben Sie den alten Pfad nicht wieder.

App-Anmeldekonten sind hier nicht gemeint​

Verwechseln Sie nicht zwei Dinge.

WasWo ändern
App-AnmeldekontoKonto, mit dem sich Personen im Studio anmeldenIn der App unter Einstellungen → Benutzerverwaltung
AI-SchlüsselAnthropic · OpenAI-kompatibler Gateway-SchlüsselDieses Dokument — bin/passwd.sh
Versuchen Sie nicht, das App-Konto über .env zu ändern — das wird eine tote Änderung

Der Studio-Server prüft beim Anmelden ①DB → ②Umgebungsvariablen. Ist das Konto in der DB angelegt, ist damit Schluss. Danach hat eine Änderung an STUDIO_LOCAL_USERS in der env keine Wirkung mehr.

App-Konten werden in Einstellungen → Benutzerverwaltung erstellt, Rollen zugewiesen und Passwörter zurückgesetzt. Details dazu finden Sie im Abschnitt Benutzerverwaltung unter Einstellungen (Administrator). Konten mit der Quelle 환경변수 können in der Oberfläche nicht bearbeitet oder gelöscht werden.

Das Bootstrap-Konto (STUDIO_LOCAL_USERS) ist ein temporäres Mittel für den ersten Zugang. Sobald ein Betriebskonto bereitsteht, leeren Sie es und starten Sie neu.

Was lässt sich ändern​

Sehen Sie sich zuerst die Liste an. Sie erhalten sie auch ohne Argumente.

cd /opt/kopens/plantpulse-studio-docker
bin/passwd.sh --list

Schlüssel · ID · aktueller Wert (nur die ersten 3 Zeichen) · Ziel · wo dieser Wert liegt werden zusammen angezeigt. Um den vollständigen Wert zu sehen, verwenden Sie --list --show.

SchlüsselWasWie geändert
PS_ANTHROPIC_API_KEYAnthropic-API-SchlüsselDatei — wird beim Start des Agent-Servers geladen
PI_LLM_API_KEYOpenAI-kompatibler Gateway-SchlüsselDatei — wird beim Start des Agent-Servers geladen

Mehr sind es nicht. Die Schlüsselnamen entsprechen den Variablennamen aus .env; Aliasnamen wie anthropic gibt es nicht — bei Aliasnamen müsste man eine Tabelle pflegen, die Namen und Variablen verbindet, und diese Tabelle weicht zwangsläufig von der Realität ab.

Das DB-Passwort kann hier nicht geändert werden

🔴 Einen Schlüssel namens PG_PASSWORD gibt es nicht. Das Studio nutzt ausschließlich externes PostgreSQL (den Bundle-Container haben wir am 28.08.2026 entfernt), und die Verbindungsdaten stehen in der DATABASE_URL-Zeile der .env. Die maßgebliche Instanz dieses Kontos liegt in der PG, daher zuerst in der DB ändern, dann DATABASE_URL anpassen und anschließend bin/restart.sh.

Auch die PP_* der Plattform sind hier nicht dabei. Wenn Sie sie übergeben, wird das wie ein Tippfehler abgelehnt.

Anders als die Namen im Container

In Logs oder Quellcode erscheinen sie als ANTHROPIC_API_KEY · AI_API_KEY. Die Namen für .env und passwd.sh sind die oben genannten → Umgebungsvariablen-Referenz

Ändern​

Den Wert weglassen und über die Eingabeaufforderung eingeben ist der empfohlene Weg. So bleibt das Passwort nicht in der ps-Ausgabe oder Shell-Historie. Es wird zweimal abgefragt, um Übereinstimmung zu prüfen.

bin/passwd.sh PI_LLM_API_KEY

Sie können den Wert auch direkt als Argument übergeben.

bin/passwd.sh PS_ANTHROPIC_API_KEY=<new-value>

Wenn Sie mehrere auf einmal übergeben, wird der Neustart zu einem einzigen zusammengefasst. Verwenden Sie diese Form bei der Inbetriebnahme.

bin/passwd.sh PI_LLM_API_KEY=<new-value> PS_ANTHROPIC_API_KEY=<new-value>

Wenn Sie nur sehen wollen, was sich ändert, ohne etwas anzufassen: --dry-run.

bin/passwd.sh --dry-run PI_LLM_API_KEY=<new-value>

Bei Ausführung werden zuerst die zu ändernden Punkte und ihre Auswirkungen angezeigt, und Sie werden über [y/N] zur Bestätigung aufgefordert. Um die Bestätigung in der Automatisierung zu überspringen, verwenden Sie --yes.

In nicht-interaktiven Sitzungen kann der Wert nicht weggelassen werden

In Umgebungen ohne Terminal wie Skripten oder Cron führt das Weglassen des Werts zu einem Fehler, da keine Eingabeaufforderung angezeigt werden kann. Übergeben Sie ihn in diesem Fall im Format KEY=<value>.

Was nach der Ausführung passiert​

Die Reihenfolge ist festgelegt.

SchrittAktion
1/etc/kopens/plantpulse-studio.env auf den neuen Wert aktualisieren (Berechtigung 0600 bleibt erhalten)
2docker compose up -d --wait — Container neu erstellen, um den neuen Wert einzubrennen

Bei beiden Schlüsseln ist die Datei die maßgebliche Instanz. Es handelt sich nicht um eine Art, bei der auch das Konto des externen Dienstes geändert werden muss: Datei anpassen und neu einbrennen — fertig.

Währenddessen ist die Studio-Verbindung unterbrochen. Führen Sie dies im Wartungsfenster durch.

Bei Fehler in der Mitte​

WoZustandAufgabe
Schritt 2 (Neustart)Datei enthält bereits den neuen WertStatus über bin/status.sh prüfen und Ursache des Startfehlers beheben
Wert nicht leer lassen

PI_LLM_API_KEY verweigert den Start des Stacks, wenn es leer ist. Beim Ändern muss zwingend ein neuer Wert gesetzt und über --list geprüft werden, dass er übernommen wurde.

Überprüfung​

bin/passwd.sh --list

Wenn sich die ersten 3 Zeichen des aktuellen Werts geändert haben, ist die Änderung übernommen. Die ersten 3 Zeichen bleiben stehen, damit man auf einen Blick erkennt, ob der Standardwert noch gilt.

Zugehörige Dokumente​