Environment Variables
Most configuration lives in OmniLux's SQLite database and is managed through the web UI. These environment variables control runtime behavior that must be set before the application starts.
Core
| Variable | Default | Description |
|---|---|---|
NODE_ENV | development | Set to production for production deployments |
PORT | 4000 | HTTP port for the web UI and API |
OMNILUX_DB_PATH | data/omnilux.db (local) or /app/data/omnilux.db (Docker) | Path to the SQLite database file |
OMNILUX_LIBRARY_ROOT | /data | Root path for the media library inside the container |
OMNILUX_DOWNLOAD_PATH | /app/data/downloads | Directory for server-managed runtime files |
Metadata
| Variable | Default | Description |
|---|---|---|
TMDB_API_KEY | — | API key for The Movie Database (TMDB) metadata lookups |
GPU / Transcoding
| Variable | Default | Description |
|---|---|---|
NVIDIA_VISIBLE_DEVICES | — | NVIDIA GPUs to expose (set to all for all GPUs) |
NVIDIA_DRIVER_CAPABILITIES | — | Required capabilities (set to compute,video,utility) |
LIBVA_DRIVER_NAME | — | VA-API driver name (e.g., radeonsi for AMD GPUs) |
INFO
Most feature configuration is stored in the SQLite database, not in environment files. Use the Settings page in the web UI for normal day-to-day server configuration.