Aller au contenu

Configuration

Toutes les variables se placent dans .env ; .env.example les documente. make passe --env-file .env à Compose pour que les ports publiés (PORT, RTC_MIN_PORT, RTC_MAX_PORT) suivent aussi le .env. Sans make, utilisez docker compose --env-file .env -f docker/docker-compose.yml up -d.

Variable Rôle Défaut
PORT Port HTTP exposé par Docker sur l’hôte. 3000
DOMAIN Nom de domaine public ; sert aussi à détecter l’adresse IP annoncée. localhost
ANNOUNCED_IP Adresse IP publique annoncée aux navigateurs pour les flux. détectée depuis DOMAIN
RTC_MIN_PORT Premier port (UDP et TCP) des flux audio et vidéo. 10000
RTC_MAX_PORT Dernier port (UDP et TCP) des flux audio et vidéo ; borne le nombre de workers. 10100
NUM_WORKERS Nombre de workers mediasoup ; chaque salon tourne sur un worker et chaque worker écoute sur son port (RTC_MIN_PORT, +1, +2…). Si Coturn ou d’autres services sont sur la même machine, laissez un cœur libre (ex. 3 sur 4 cœurs). un par cœur
PEERS_PER_ROUTER Quand un salon compte ce nombre de personnes sur un worker, les suivantes vont sur un autre worker, et leurs flux sont relayés entre workers (pipeToRouter). Un grand salon n’est alors plus limité à un seul cœur (environ 20 personnes avec vidéo). 0 = un salon reste toujours sur un seul worker. 10
MAX_INCOMING_BITRATE Débit maximal reçu par participant·e, en bit/s. 3500000
INITIAL_OUTGOING_BITRATE Débit de départ envoyé à chaque participant·e, en bit/s. 2000000
HEALTH_DETAILS true : /health donne aussi le nombre de salons et de personnes connectées. désactivé
Variable Rôle Défaut
STUN_URLS Serveurs STUN, séparés par des virgules. aucun
WEBRTC_TURN_URLS Serveurs TURN, séparés par des virgules. aucun
WEBRTC_TURN_AUTH_SECRET Secret partagé Coturn pour les identifiants éphémères. aucun
WEBRTC_TURN_REALM Realm Coturn. aucun
WEBRTC_TURN_TTL Durée de validité des identifiants éphémères, en secondes. 3600
TURN_USERNAME Identifiant TURN statique (si pas de secret partagé). aucun
TURN_CREDENTIAL Mot de passe TURN statique. aucun
Variable Rôle Défaut
NEXT_PUBLIC_SOCKET_URL Adresse du serveur de signalisation, si elle diffère de la page. adresse de la page
NEXT_PUBLIC_SOURCE_URL Lien « Code source » du pied de page. À changer si vous déployez une version modifiée (obligation de l’AGPL). dépôt Codeberg
NEXT_PUBLIC_DOCS_URL Adresse du site de documentation, utilisée par les liens « Documentation » et « Auto-héberger » de la page d’accueil. site de documentation officiel

Les variables NEXT_PUBLIC_* sont intégrées au code au moment de npm run build : pour les changer avec Docker, il faut reconstruire l’image (make build).

Variable Rôle Défaut
FRAME_ANCESTORS Sites autorisés à intégrer Visio dans une <iframe>, séparés par des espaces (ex. https://militant.example.org). Le serveur envoie Content-Security-Policy: frame-ancestors. Les entrées invalides sont ignorées. vide : tout site peut l’intégrer
MEMORY_LIMIT Mémoire maximale du conteneur. 1g
PIDS_LIMIT Nombre maximal de processus du conteneur. 512

Le conteneur tourne sans privilèges : no-new-privileges, aucune capacité Linux (cap_drop: ALL), système de fichiers en lecture seule (seul /tmp est inscriptible). Le serveur envoie Strict-Transport-Security, X-Content-Type-Options, Referrer-Policy et Permissions-Policy, et ne révèle plus X-Powered-By.