LiveKit en local

Faire tourner LiveKit en local

Ce que ça fait

Démarre un serveur LiveKit en mode développement, pour tester @legba-core/realtime sans dépendre d’un serveur distant.

Commande

docker compose up -d

Résultat

  • LiveKit écoute sur ws://localhost:7880 (signalisation), 7881 (RTC TCP, repli) et 7882/udp (RTC UDP, médias).
  • Clés API : devkey / secret (voir .env.example) — pour développement uniquement, jamais en production.
  • Vérifier que ça tourne : curl http://localhost:7880 doit répondre OK.

Arrêter

docker compose down

Pièges

  • room.auto_create: false est volontaire (déjà dans docker-compose.yml) : sans ça, LiveKit recrée silencieusement toute salle fermée dès qu’un jeton valide tente de la rejoindre, ce qui rendrait closeRoom inopérant. @legba-core/realtime suppose un cycle de vie de salle explicite (createRoom/closeRoom), pas la création implicite à la connexion.
  • Sans --bind 0.0.0.0 (déjà dans docker-compose.yml), LiveKit n’écoute que sur la boucle locale du conteneur et reste injoignable depuis l’hôte.
  • Ces clés (devkey/secret) sont volontairement faibles pour le développement local : LiveKit avertit qu’un secret de production doit faire au moins 32 caractères.