Skip to content

Configuration

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.