Zum Hauptinhalt springen

Umgebungsvariablen

Diese Seite behandelt zwei Konfigurationsebenen: Docker-Bereitstellungsvariablen, die zum Installationszeitpunkt gesetzt werden, und Laufzeit-Systemparameter, die über die OpSee-Oberfläche konfigurierbar sind.


Bereitstellungsvariablen​

Diese Variablen werden in .env-Dateien im Stammverzeichnis der Bereitstellung definiert und beim Start von Docker Compose verwendet. Die .env-Datei wird niemals in die Versionskontrolle eingecheckt — wenden Sie sich an Ihren Systemadministrator, um die tatsächlich verwendeten Werte Ihrer Installation zu erhalten.

Anwendung​

VariableBeschreibungBeispiel
SERVER_DOMAINÖffentlicher Domänenname der OpSee-Instanzopsee.example.com

Grafana​

VariableBeschreibung
GF_SECURITY_ADMIN_USERGrafana-Administrator-Benutzername
GF_SECURITY_ADMIN_PASSWORDGrafana-Administrator-Passwort

Keycloak​

VariableBeschreibung
KEYCLOAK_ADMINKeycloak-Administrator-Benutzername
KEYCLOAK_ADMIN_PASSWORDKeycloak-Administrator-Passwort

PostgreSQL​

VariableBeschreibung
POSTGRES_DBName der PostgreSQL-Datenbank (OpSee standardmäßig)
POSTGRES_USERDatenbankbenutzer für die Anwendung
POSTGRES_PASSWORDPasswort für den Datenbankbenutzer
hinweis

Alle Bereitstellungsvariablen werden einmalig bei der Installation gesetzt. Eine Änderung nach dem Start der Container erfordert einen Neustart der betroffenen Dienste. Stimmen Sie alle Änderungen mit Ihrem Infrastruktur-Administrator ab.


Systemparameter (Oberfläche)​

Die Laufzeitkonfiguration, die keinen Container-Neustart erfordert, wird über Administration → Systemparameter in der OpSee-Oberfläche verwaltet. Diese Parameter steuern das Verhalten auf Anwendungsebene und werden in der Datenbank gespeichert.

Häufige Systemparameter sind:

  • Standardsprache: die Sprache, die Benutzern angezeigt wird, die keine persönliche Präferenz festgelegt haben
  • Zeitzone: die Zeitzone, die zur Anzeige von Zeitstempeln und zur Planung von Schichten verwendet wird
  • Maßeinheiten: systemweite Einheitenpräferenzen (metrisch / imperial) für Dauer- und Mengenfelder
  • Dauerformat: wie Stillstandsdauern angezeigt werden (z. B. 04h 32m vs. 272 min)

Für lokalisierungsbezogene Parameter (Sprache, Zeitzone, Datumsformat) siehe die Seite Lokalisierung im Administrationsbereich.