Environment Variables
Complete reference of all environment variables used by Confo.
Backend
These variables configure the main Confo application container (ghcr.io/vasimi/confo).
Core
| Variable | Required | Default | Description |
|---|---|---|---|
JWT_SECRET | No | Random | Secret key used to sign JWT authentication tokens. Use a long, random string. If omitted, a random secret is generated on startup — sessions will not persist across restarts and this will not work in HA/multi-instance setups. |
PORT | No | 3000 | Port the backend API server listens on. Rarely needs changing in Docker. |
CORS_ORIGIN | No | — | Comma-separated list of allowed CORS origins (e.g. https://confo.example.com). |
NODE_ENV | No | — | Set to production to disable automatic database schema synchronization and run pending TypeORM migrations automatically on container startup. See Database Migrations. |
NG_ALLOWED_HOSTS | No | — | Comma-separated list of hostnames the Angular SSR server will render for (e.g. confo.example.com). If unset, SSR falls back to client-side rendering for any non-matching host and logs a warning. Set this to your public domain when deploying behind a reverse proxy. See Angular SSRF guidance. |
Database
| Variable | Required | Default | Description |
|---|---|---|---|
DATABASE_TYPE | Yes | — | Database driver. Use mariadb. |
DATABASE_HOST | Yes | — | Database server hostname (e.g. mariadb when using Docker Compose). |
DATABASE_PORT | No | 3306 | Database server port. |
DATABASE_USERNAME | Yes | — | Database user. |
DATABASE_PASSWORD | Yes | — | Database password. |
DATABASE_NAME | Yes | — | Database name (e.g. confo). |
Superadmin Seed
These variables are used on first startup to create the initial superadmin account.
| Variable | Required | Default | Description |
|---|---|---|---|
SUPERADMIN_USERNAME | Yes | — | Username for the initial superadmin account. |
SUPERADMIN_PASSWORD | Yes | — | Password for the initial superadmin account. |
YouTube Integration
These variables are only required if you use the YouTube integration.
| Variable | Required | Default | Description |
|---|---|---|---|
YOUTUBE_CLIENT_ID | No | — | Google OAuth 2.0 client ID. |
YOUTUBE_CLIENT_SECRET | No | — | Google OAuth 2.0 client secret. |
OBS Bridge
These variables configure the OBS Bridge container (ghcr.io/vasimi/confo/obs-bridge).
| Variable | Required | Default | Description |
|---|---|---|---|
OBS_HOST | No | localhost | Hostname or IP of the machine running OBS Studio. |
OBS_PORT | No | 4455 | OBS WebSocket server port. |
OBS_PASSWORD | No | — | OBS WebSocket server password. Leave empty if OBS has no password set. |
BACKEND_URL | No | http://localhost:3000 | URL of the Confo backend API (e.g. http://confo:3000 in Docker Compose). |
ROOM_ID | Yes | — | The room ID (from Confo) that this OBS Bridge instance is associated with. |
RECONNECT_DELAY | No | 5000 | Delay in milliseconds before attempting to reconnect to OBS or the backend after a disconnection. |