Environment Variables
This page covers two levels of configuration: Docker deployment variables set at install time, and runtime system parameters configurable through the OpSee UI.
Deployment variables
These variables are defined in .env files at the root of the deployment and are consumed by Docker Compose at startup. The .env file is never committed to version control. Contact your system administrator for the actual values used in your installation.
Application
| Variable | Description | Example |
|---|---|---|
SERVER_DOMAIN | Public domain name of the OpSee instance | opsee.example.com |
Grafana
| Variable | Description |
|---|---|
GF_SECURITY_ADMIN_USER | Grafana administrator username |
GF_SECURITY_ADMIN_PASSWORD | Grafana administrator password |
Keycloak
| Variable | Description |
|---|---|
KEYCLOAK_ADMIN | Keycloak administrator username |
KEYCLOAK_ADMIN_PASSWORD | Keycloak administrator password |
PostgreSQL
| Variable | Description |
|---|---|
POSTGRES_DB | Name of the PostgreSQL database (OpSee by default) |
POSTGRES_USER | Database user for the application |
POSTGRES_PASSWORD | Password for the database user |
All deployment variables are set once at installation time. Changing them after the containers are running requires restarting the affected services. Coordinate any changes with your infrastructure administrator.
System parameters (UI)
Runtime configuration that does not require a container restart is managed through Administration → System Parameters in the OpSee interface. These parameters control application-level behavior and are stored in the database.
Common system parameters include:
- Default language: the language displayed to users who have not set a personal preference
- Timezone: the timezone used for displaying timestamps and scheduling shifts
- Units of measure: system-wide unit preferences (metric / imperial) for duration and quantity fields
- Duration format: how downtime durations are displayed (e.g.
04h 32mvs272 min)
For localization-related parameters (language, timezone, date format), see the Localization page in the Administration section.