Jitsi

Projet : Jitsi Meet (visioconférence auto-hébergée, usage local / LAN) Date de début : 2026-09-19 Statut : ✅ Terminé — pile opérationnelle, 4/4 conteneurs sains


1. Environnement et contraintes

  • OS hôte : Fedora 44 (noyau 7.1.13-200.fc44.x86_64).
  • Environnement de l’agent : je (l’assistant IA) tourne dans un bac à sable Flatpak (Freedesktop SDK 26.08) — ❌ pas de sudo, ❌ pas de binaire Docker, ❌ pas de systemd accessible dans le bac à sable.
  • Conséquence : je n’exécute rien moi-même sur l’hôte. C’est moi qui lance les commandes sur mon terminal Fedora, puis je colle la sortie dans Jitsi Setup Commands Results.md pour que l’agent l’interprète et mette à jour ce rapport.

2. Approche retenue

Exécuter la release officielle docker-jitsi-meet (pile Docker Compose), plutôt qu’une installation manuelle — c’est le chemin supporté et tout reste isolé.

Important (appris en lisant la doc, sept. 2026) :

  • Depuis la release stable-11146, les conteneurs sont rootless et en lecture seule : ils tournent en uid/gid 1000, et les répertoires de config storage + tmp doivent être créés à l’avance et rendus accessibles en écriture (chmod 777), sinon un service refuse de démarrer avec une erreur explicite.
  • PUBLIC_URL doit pointer vers une URL réellement accessible (le défaut meet.jitsi est un placeholder interne qui ne marche pas depuis un navigateur).
  • L’accès HTTP direct (port 8000) casse la WebRTC caméra/micro (navigator.mediaDevices is undefined). Utiliser HTTPS sur 8443 avec le certificat auto-signé généré et accepter l’avertissement du navigateur.
  • Pour de petits tests locaux : 🚫 pas de git clone — le ZIP de release est la méthode supportée (master ne correspond qu’aux images unstable).
  • Si d’autres appareils du LAN doivent se connecter, renseigner JVB_ADVERTISE_IPS avec l’IP LAN de l’hôte (connexion via https://<ip-hote>:8443).

3. Étapes chronologiques

Phase 0 — Vérifier les prérequis (Docker sur l’hôte) ✅ FAIT

docker --version && docker compose version

Sortie réelle :

Docker version 29.8.0, build 88096ef
Docker Compose version v5.0.0-desktop.1

→ Docker + Compose étaient déjà installés (docker-ce 29.8.0, plugin compose 5.5.1). Rien à faire. J’ai quand même tenté le chemin d’installation pour être sûr ; tous les paquets sont « already installed ». ✅

Si Docker est absent sur Fedora, installer Docker CE :

sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER    # puis se reconnecter / newgrp docker

Phase 1 — Télécharger la dernière release ⚠️ CORRIGÉE

mkdir -p ~/jitsi && cd ~/jitsi
wget $(wget -q -O - https://api.github.com/repos/jitsi/docker-jitsi-meet/releases/latest | grep zip | cut -d\" -f4)
unzip jitsi-meet-*.zip && cd jitsi-meet-*

→ ❌ Le grep zip a attrapé l’URL zipball de GitHub ; wget a suivi la redirection vers codeload.github.com/…/legacy.zip/refs/tags/stable-11248 et a enregistré le fichier sous stable-11248 (sans extension .zip) → unzip jitsi-meet-*.zip a échoué.

✅ Corrigé — la release est stable-11248 :

cd ~/jitsi
mv stable-11248 jitsi-meet-stable-11248.zip
unzip jitsi-meet-stable-11248.zip
cd jitsi-meet-*   # ou cd vers le dossier extrait affiché par ls

→ Extraction OK : dossier jitsi-docker-jitsi-meet-276801c (commit zipball 276801c). Téléchargement/installation ✅ — mais voir le quirk de contexte Docker ci-dessous (sonde docker ps).

Correction du contexte Docker ✅ — après docker context use default + sudo systemctl enable --now docker + usermod -aG docker + newgrp docker, le daemon est active et docker ps fonctionne sans sudo. Le contexte default est le vrai daemon home-lab (conteneurs RocketChat, Supabase, Misskey, freeCodeCamp visibles) ; desktop-linux est un contexte Docker Desktop obsolète. Phase 1 terminée.

Phase 2 — Configurer .env ✅ FAIT

Réglages appliqués : PUBLIC_URL=https://192.168.1.150:8443, JVB_ADVERTISE_IPS=192.168.1.150, ENABLE_LETSENCRYPT=0, ENABLE_HTTP_REDIRECT=0, TZ=Etc/GMT, HTTP_PORT=8000, HTTPS_PORT=8443, plus les mots de passe générés (JICOFO_AUTH_PASSWORD, JVB_AUTH_PASSWORD). Tableau complet dans Jitsi - Config + Details.md.

cp env.example .env
./gen-passwords.sh          # mots de passe forts, sauvegarde dans .env.bak
nano .env                   # appliquer les réglages locaux — voir « Jitsi - Config + Details.md »

Modifications clés pour un usage local :

# URL publique (placeholder : mettre l'IP LAN de l'hôte si accès LAN requis)
PUBLIC_URL=https://localhost:8443
ENABLE_LETSENCRYPT=0
ENABLE_HTTP_REDIRECT=0
# Média LAN
JVB_ADVERTISE_IPS=          # ex. 192.168.1.x — requis si les utilisateurs LAN doivent se connecter

Phase 3 — Créer les répertoires CONFIG (layout rootless)

mkdir -p ~/.jitsi-meet-cfg/{web,prosody/config,prosody/prosody-plugins-custom,jicofo,jvb,jigasi,jibri,transcriber}
mkdir -p ~/.jitsi-meet-cfg/storage/{jibri,prosody,transcripts,web}
mkdir -p ~/.jitsi-meet-cfg/tmp/{web-crontabs,web-load-test}
chmod 777 ~/.jitsi-meet-cfg/storage/{jibri,prosody,transcripts,web}
chmod 777 ~/.jitsi-meet-cfg/tmp/{web-crontabs,web-load-test}

Phase 4 — Démarrer la pile ✅ FAIT

docker compose up -d
docker compose ps

Première tentative ❌ : jvb a encore échoué sur 127.0.0.1:8080 (le sed avait été un no-op, voir Erreurs). Après ajout de JVB_COLIBRI_PORT=18080 au .env et docker compose up -d --force-recreate jvb ✅ :

jicofo   Up 16 minutes   127.0.0.1:8888->8888/tcp
jvb      Up 57 seconds   0.0.0.0:10000->10000/udp, [::]:10000->10000/udp, 127.0.0.1:18080->8080/tcp
prosody  Up 16 minutes   5222/tcp, 5269/tcp, 5280/tcp, 5347/tcp
web      Up 15 minutes   0.0.0.0:8000->8000/tcp, [::]:8000->8000/tcp, 0.0.0.0:8443->8443/tcp, [::]:8443->8443/tcp

Phase 5 — Vérifier ✅ FAIT

  • curl -k -sI https://192.168.1.150:8443 → HTTP/2 200, serveur nginx ✅
  • docker compose logs --tail=15 jicofo jvb | grep -iE "error|exception|fatal" → aucune erreur ✅
  • docker compose top → process java pour jicofo/jvb, lua pour prosody, nginx master + 4 workers — tout tourne en uid non-root ✅
  • curl -s http://127.0.0.1:18080/colibri/stats → 404 ⚠️ (endpoint déplacé dans le JVB stable-11248 recodé en ktor) — sans impact en local ; le web répond 200 et les logs sont propres. Test final = navigateur.

4. Erreurs

❌ / ✅Erreur / correction
❌J’ai essayé sudo dnf config-manager --add-repo … → Unknown argument "--add-repo" (la syntaxe dnf5 a changé).
✅Correction : sans conséquence ici — Docker était déjà installé (Nothing to do.). Si le dépôt doit vraiment être ajouté sous dnf5 : sudo dnf config-manager addrepo --from-repofile=… ou installer dnf-plugins-core d’abord.
❌`wget $(…
✅Correction : mv stable-11248 jitsi-meet-stable-11248.zip && unzip jitsi-meet-stable-11248.zip — release confirmée : stable-11248.
❌docker ps → failed to connect to the docker API at unix:///home/sambasene/.docker/desktop/docker.sock … no such file — le contexte Docker actif pointe vers le socket de Docker Desktop, mais Docker Desktop ne tourne pas (la version compose v5.0.0-desktop.1 était le premier indice).
✅Correction : basculer sur le moteur classique — docker context use default (ou désactiver DOCKER_HOST), puis sudo systemctl enable --now docker + sudo usermod -aG docker $USER + newgrp docker.
❌J’ai lancé le bloc d’édition .env depuis ~ au lieu du dossier projet → sed: can't read .env: No such file or directory ×6, idem grep.
✅Correction : cd ~/jitsi/jitsi-docker-jitsi-meet-276801c d’abord, puis relancer le bloc (un shell neuf avait perdu le cd précédent).
❌docker compose up -d → jvb a refusé de démarrer : failed to bind host port 127.0.0.1:8080/tcp: address already in use — l’API REST Colibri du JVB est publiée sur 127.0.0.1:${JVB_COLIBRI_PORT:-8080}:8080 par défaut, et autre chose occupe déjà le 8080 sur l’hôte.
✅Correction : remapper l’API REST — ajouter JVB_COLIBRI_PORT=8081 dans le .env (toujours bindé sur 127.0.0.1 uniquement, donc aucune exposition LAN). Relancer docker compose up -d.
❌Le `sed ‘s
✅Correction : ajouter la variable au lieu de la sed-er — choisir un port vérifié libre, ex. printf '\nJVB_COLIBRI_PORT=18080\n' >> .env → docker compose up -d --force-recreate jvb. Leçon : clé absente → append avec >>, pas de sed.
✅jvb recréé : 8080/tcp -> 127.0.0.1:18080 (REST colibri) + 10000/udp -> 0.0.0.0:10000 (médias RTP). Pile complète : web/prosody/jicofo/jvb tous Up.

5. Constats (cause racine)

Constat
Le conteneur jvb ne peut pas démarrer sans ports publiés : compose publie l’API REST Colibri sur 127.0.0.1:${JVB_COLIBRI_PORT:-8080}:8080 ; si l’hôte occupe déjà ce port (ici un service uvicorn sur 8080), la création de jvb échoue avec « address already in use » et aucun repli n’a lieu — le conteneur reste sans aucun port (docker port vide).
.env est une copie de env.example : une expression sed ne patche que les lignes existantes. JVB_COLIBRI_PORT n’est pas présent dans l’env.example de stable-11248 → sed silent no-op → compose utilise silencieusement le défaut :-8080. Correction = append de la clé (printf … >> .env) après vérification que le port choisi est libre (ss -tlnup).
Le scan des ports avant de choisir le remplaçant est obligatoire : le « évident » 8081 était déjà occupé par dart:server.dar (un serveur de dev Dart/Flutter de l’hôte). 18080 était libre.
Images rootless (stable-11146+) : les services tournent en uid/gid 1000 ; les répertoires storage + tmp en 777 pré-créés sont requis (Phase 3) sinon la pile ne démarre pas.

6. Tableau de statut

ComposantFonctionne ?PrioritéNotes
Moteur Docker 29.8.0✅hautedaemon actif, daemon home-lab (contexte default)
Docker Compose v5✅hauteplugin compose 5.5.1
Release Jitsi stable-11248✅hauteextraite vers ~/jitsi/jitsi-docker-jitsi-meet-276801c
Web Jitsi (nginx) sur 8443✅hautecurl -k → HTTP/2 200 nginx
Prosody (XMPP)✅hauteUp, 5222/5269/5280/5347, process lua actif
Jicofo (focus)✅hauteUp, REST 127.0.0.1:8888, process java actif
JVB (pont vidéo) UDP 10000✅hauteUp, 10000/udp + 127.0.0.1:18080->8080 ; colibri /stats → 404 (endpoint déplacé) sans impact
Optionnels : Jibri/Jigasi/Etherpad—bassepas activés au départ

7. Tableau identifiants / configuration

ÉlémentValeurEmplacement
Interface web (local)https://localhost:8443navigateur
Interface web (LAN)https://192.168.1.150:8443navigateur (accepter le certificat auto-signé)
REST Colibri JVB127.0.0.1:18080 (hôte) → 8080 (conteneur).env → JVB_COLIBRI_PORT=18080
REST Jicofo127.0.0.1:8888défaut compose
Ports média UDP10000/udp (JVB_PORT)pare-feu déjà ouvert
Mots de passe (internes)générés par ./gen-passwords.sh~/jitsi/jitsi-meet-*/.env
Domaine XMPPmeet.jitsi (interne, défaut).env

⚠️ Tous les mots de passe internes sont générés ; garder .env privé. Ne jamais réutiliser les mots de passe générés entre deux installations.

8. Bloc de configuration réutilisable

Voir Jitsi - Config + Details.md pour les valeurs .env appliquées une fois la config de conférence arrêtée.

9. Dernier instantané de vérification

2026-09-19 11:14 — 4/4 conteneurs Up, docker compose ps :

jicofo  Up 16 minutes   127.0.0.1:8888->8888/tcp
jvb     Up 57 seconds   0.0.0.0:10000->10000/udp, [::]:10000->10000/udp, 127.0.0.1:18080->8080/tcp
prosody Up 16 minutes   5222/tcp, 5269/tcp, 5280/tcp, 5347/tcp
web     Up 15 minutes   0.0.0.0:8000->8000/tcp, [::]:8000->8000/tcp, 0.0.0.0:8443->8443/tcp, [::]:8443->8443/tcp

curl -k -sI https://192.168.1.150:8443 → HTTP/2 200 nginx. Aucune ligne d’erreur dans les logs jicofo/jvb. Test navigateur à venir.

10. Travaux futurs / leçons

  • Test navigateur : https://192.168.1.150:8443 → créer une salle, vérifier micro/caméra
  • Second participant depuis un autre appareil du LAN (même URL, même salle)
  • Optionnel : activer le partage de documents Etherpad (etherpad.yml)
  • Optionnel : activer le tableau blanc Excalidraw (whiteboard.yml)
  • Optionnel : auth JWT, enregistrement Jibri, SIP jigasi
  • Optionnel : exposition sur Internet derrière un reverse proxy (+ vrai certificat Let’s Encrypt)

Leçons apprises :

  1. Toujours vérifier avec ss -tlnup le port de remplacement avant d’éditer le .env — mordu deux fois (8080 par uvicorn, 8081 par un serveur de dev Dart).
  2. sed ne patche que les lignes existantes : une clé absente de env.example nécessite un append (>>), puis vérification avec grep.
  3. Les images rootless exigent des répertoires storage/tmp pré-créés en 777 — lire les notes de release stable-11146+ avant de deviner.
  4. Préférer les ZIP de release au git clone ; un grep zip de wget peut enregistrer le fichier sans son extension.
  5. La colonne PORTS de docker compose ps est la sonde santé la plus rapide : une ligne vide = le bind a échoué à la création.

Ce rapport est écrit à la première personne — c’est moi qui réalise le travail sur ma machine, l’agent interprète les résultats que je colle.