All variables go in .env; .env.example documents them. make passes --env-file .env to Compose so the published ports (PORT, RTC_MIN_PORT, RTC_MAX_PORT) follow the .env too. Without make, use docker compose --env-file .env -f docker/docker-compose.yml up -d.
| Variable |
Purpose |
Default |
PORT |
HTTP port exposed by Docker on the host. |
3000 |
DOMAIN |
Public domain name; also used to detect the announced IP address. |
localhost |
ANNOUNCED_IP |
Public IP address announced to browsers for the streams. |
detected from DOMAIN |
RTC_MIN_PORT |
First port (UDP and TCP) for audio and video streams. |
10000 |
RTC_MAX_PORT |
Last port (UDP and TCP) for audio and video streams; caps the number of workers. |
10100 |
NUM_WORKERS |
Number of mediasoup workers; each room runs on one worker and each worker listens on its own port (RTC_MIN_PORT, +1, +2…). If Coturn or other services share the machine, leave one core free (e.g. 3 on 4 cores). |
one per core |
PEERS_PER_ROUTER |
Once a room has this many people on one worker, the next ones go to another worker and their streams are relayed between workers (pipeToRouter). A large room is then no longer limited to one core (about 20 people with video). 0 = a room always stays on one worker. |
10 |
MAX_INCOMING_BITRATE |
Maximum bitrate received per participant, in bit/s. |
3500000 |
INITIAL_OUTGOING_BITRATE |
Starting bitrate sent to each participant, in bit/s. |
2000000 |
HEALTH_DETAILS |
true: /health also reports the number of rooms and connected people. |
off |
| Variable |
Purpose |
Default |
STUN_URLS |
STUN servers, comma-separated. |
none |
WEBRTC_TURN_URLS |
TURN servers, comma-separated. |
none |
WEBRTC_TURN_AUTH_SECRET |
Coturn shared secret for ephemeral credentials. |
none |
WEBRTC_TURN_REALM |
Coturn realm. |
none |
WEBRTC_TURN_TTL |
Lifetime of ephemeral credentials, in seconds. |
3600 |
TURN_USERNAME |
Static TURN username (when there is no shared secret). |
none |
TURN_CREDENTIAL |
Static TURN password. |
none |
| Variable |
Purpose |
Default |
NEXT_PUBLIC_SOCKET_URL |
Signalling server address, if it differs from the page. |
page address |
NEXT_PUBLIC_SOURCE_URL |
“Source code” link in the footer. Change it if you deploy a modified version (AGPL requirement). |
Codeberg repository |
NEXT_PUBLIC_DOCS_URL |
Address of the documentation website, used by the “Documentation” and “Self-host” links on the home page. |
official documentation site |
NEXT_PUBLIC_* variables are baked into the code by npm run build: to change them with Docker, rebuild the image (make build).
| Variable |
Purpose |
Default |
FRAME_ANCESTORS |
Sites allowed to embed Visio in an <iframe>, space-separated (e.g. https://militant.example.org). The server sends Content-Security-Policy: frame-ancestors. Invalid entries are ignored. |
empty: any site can embed it |
MEMORY_LIMIT |
Maximum memory of the container. |
1g |
PIDS_LIMIT |
Maximum number of processes in the container. |
512 |
The container runs without privileges: no-new-privileges, no Linux capability (cap_drop: ALL), read-only filesystem (only /tmp is writable). The server sends Strict-Transport-Security, X-Content-Type-Options, Referrer-Policy and Permissions-Policy, and no longer reveals X-Powered-By.