Umgebungsvariablen – Referenz

Eine vollständige Übersicht der Umgebungsvariablen, die der Studio-Server liest. Anders als Werte, die Sie auf der Oberfläche (Einstellungen) ändern, müssen Änderungen hier die Datei bearbeitet und den Server neu gestartet werden, um wirksam zu werden.

Die autoritative Quelle ist `/etc/kopens/plantpulse-studio.env`

/etc/kopens/plantpulse-studio.env

Das Repository-Stammverzeichnis .env wird nicht mehr gelesen

Wenn Sie Werte in den alten Pfad (Installationsverzeichnis .env) eintragen, werden sie nicht angewendet. Wenn die alte Datei noch vorhanden ist, werden Sie von einem Skript benachrichtigt. Nutzen Sie beim Ändern von Werten den oben genannten autoriativen Pfad.

Setzen Sie die Berechtigungen auf chmod 600 — diese Datei enthält API-Schlüssel.

Image und Version

Variable	Standard	Beschreibung
`REGISTRY`	`docker.kopens.io/ps`	Registry, von der Images abgerufen werden. Wenn leer, werden nur lokale Tags verwendet (bei manueller Erstellung)
`TAG`	(leer)	Image-Tag
`AGENT_SERVER_TAG`	Variiert je nach Installation	Image-Tag des Agent-Servers

TAG sollte leer gelassen werden

Wenn leer, folgt bin/start.sh automatisch der Version aus der Datei VERSION mit jedem Release. Wenn Sie hier einen Wert manuell eintragen, wird er beibehalten — deshalb ist es vorgekommen, dass ein Image von vor einem Monat gestartet wurde.

Wenn Sie an einem bestimmten Release-Stand fixieren möchten, verwenden Sie einen Snapshot-Tag — beispielsweise TAG=2026.08-20260810.

Gebietsschema und Zeitzone

Verwendet dieselben Variablennamen wie Platform und Edge.

Variable	Standard	Beschreibung
`PP_LANG`	`en`	Standard-Websprache (`ko` / `en`). Im Browser gespeicherte Werte haben Vorrang
`PP_TZ`	`Asia/Seoul`	IANA-Zeitzonen-ID. Maßstab für relative Zeitinterpretation wie "heute / gestern"

Für koreanische Vor-Ort-Anlagen, setzen Sie PP_LANG=ko.

Speicherort für Daten

Variable	Standard	Beschreibung
`DATA_ROOT`	`/var/lib/pp-studio`	Arbeitsbereiche, Build-Artefakte, Zustand und gebündelte PG-Daten werden alle unterhalb dieses Pfades gespeichert

Dies ist das Ziel für Sicherungen → Sicherung und Wiederherstellung.

Datenbank — einer von zwei Modi

(a) Gebündelte PostgreSQL (Standard) — Studio startet seinen eigenen PG-Container.

Variable	Standard
`COMPOSE_PROFILES`	`bundled-pg`
`PG_DB`	`ppstudio`
`PG_USER`	`ppstudio`
`PG_PASSWORD`	`change-me-please` — Sie müssen dies ändern

(b) Gemeinsame PostgreSQL — Sie nutzen die Platform-PG (redundante Infrastruktur entfernen).

Löschen Sie die Zeile COMPOSE_PROFILES und geben Sie nur die Verbindungsadresse an.

Variable	Beispiel
`DATABASE_URL`	`postgres://<user>:<password>@<db-host>:5432/ps`

PostgreSQL-Passwort sollte vom ursprünglichen Wert beibehalten werden

Die gebündelte PG erstellt das Benutzerkonto beim ersten Start, wenn es das Datenverzeichnis anlegt. Wenn Sie später nur PG_PASSWORD ändern, führt dies zu einem Konflikt zwischen dem Konto in der DB und der Stack startet nicht. Zum Ändern müssen Sie zuerst das Kontokennwort in PostgreSQL ändern — Passwörter und API-Schlüssel ändern unter passwd.sh führt diese Schritte für Sie durch.

Platform-Integration

Variable	Beispiel	Beschreibung
`PLATFORM_API_TARGET`	`https://192.168.0.41`	Platform-Adresse für Echtzeitdatenabruf und delegierte Login-Authentifizierung

App-Listener (Vorschau · bereitgestellte Apps)

Variable	Standard	Beschreibung
`APPS_PORT`	`5171`	Separater Listener-Port zum Bereitstellen von Vorschau- und bereitgestellten Apps

Installation mit direktem Portzugriff — Sie müssen diesen Port auch in der Firewall öffnen, damit Vorschau, bereitgestellte Apps und QR-Zugriff funktionieren.
Hinter Reverse Proxy — Sie müssen ihn nicht öffnen. Der Proxy leitet /container, /preview und /apps auf der gleichen Domain an diesen Listener weiter → Domain und Reverse Proxy.

"App Origin" (APPS_ORIGIN) wurde entfernt

Entfernt am 2026-08-23. Wenn der Wert leer ist, fällt die Vorschau-URL auf 요청호스트:5171 zurück — Live-Vorschau ist in Konfigurationen, die nur die Ports 80/443 freigeben, komplett fehlgeschlagen. Jetzt verwenden Clients nur relative Pfade.

KI-Anbieter

Diese Werte sind Ausgangswerte. Werte, die Sie auf der Oberfläche eingeben (Einstellungen → KI), setzen diese Werte außer Kraft.

Variable	Standard	Beschreibung
`AI_PROVIDER`	`openai-compatible`	Wenn leer, dann immer `openai-compatible`
`AI_BASE_URL`	(leer)	Gateway-Adresse. Wir setzen keinen Standard-Wert
`AI_MODEL`	`gpt-4o`	Modellname
`AI_API_KEY`	(leer)	OpenAI-kompatibler Schlüssel
`ANTHROPIC_API_KEY`	(leer)	Nur bei Verwendung von Cloud Claude

Warum wir keinen plausiblen Standard für AI_BASE_URL setzen

Wenn kein Gateway auf diesem Host vorhanden ist, wird der Chat komplett zu fetch failed, aber weil der Wert plausibel aussieht, ist es schwer, die Ursache zu finden. Geben Sie die tatsächliche Adresse an. Sie können überprüfen, ob der eingegebene Wert korrekt ist, mit der Verbindungsprüfung auf der Registerkarte Einstellungen → KI vor dem Speichern → Einstellungen (Administrator).

Wir leiten den Anbieter nicht aus dem Schlüssel ab

Früher wurde der Anbieter danach ausgewählt, welcher Schlüssel vorhanden war, aber dies war nicht vorhersehbar, je nach env-Konfiguration (entfernt 2026-08-23).

CORS

Variable	Standard	Beschreibung
`STUDIO_CORS_ORIGINS`	(leer = same-origin)	Nur angeben, wenn Sie von einer anderen Domain aus zugreifen

Was nicht per Umgebungsvariable übermittelt wird

Benutzerkonten und Rollen werden nicht als Umgebungsvariablen definiert. Wenn der Server keine Konten hat, pflanzt er einen Administrator in die DB, und danach fügen Sie Konten hinzu, löschen sie und weisen Rollen (admin / builder / viewer) über den Bildschirm Benutzerverwaltung zu.

→ Erstkennwort ändern

Die autoritative Quelle ist /etc/kopens/plantpulse-studio.env​

Image und Version​

Gebietsschema und Zeitzone​

Speicherort für Daten​

Datenbank — einer von zwei Modi​

Platform-Integration​

App-Listener (Vorschau · bereitgestellte Apps)​

KI-Anbieter​

CORS​

Was nicht per Umgebungsvariable übermittelt wird​

Verwandte Dokumentation​