# Element Call + LiveKit Deployment Notes

Resumen rápido de los pasos que seguimos para que Element Web use LiveKit como backend:

1. **Synapse listo para MatrixRTC**
   - Listener HTTP con `resources: [client, federation, openid]`.
   - Flags `experimental_features` (MSC3266/4222/4354), `max_event_delay_duration`, `rc_message` y `rc_delayed_event_mgmt` activados.
   - Reinicio de `synapse` tras editar `synapse_data/homeserver.yaml`.

2. **Stack base en Docker**
   - `docker-compose.yml` levanta Synapse, Element Web, Synapse Admin y el proxy `wellknown` (Nginx).
   - El proxy sirve `/.well-known/...` y ahora también enruta `/livekit/jwt` y `/livekit/sfu`.

3. **Servicios LiveKit**
   - `docker-compose.livekit.yml` inicia `livekit` y `livekit-jwt`.
   - `configs/livekit/livekit.yaml` define puertos, región y las claves `LIVEKIT_API_KEY/SECRET`.
   - `extra_hosts` para que `livekit` y `livekit-jwt` resuelvan `matrix-af2f3d...` y `matrix-rtc-320bd4...` al Traefik interno (`10.10.10.6`).

4. **Traefik / Coolify**
   - Routers para:
     - `element-a05ae4...` → contenedor Element Web.
     - `matrix-af2f3d...` → Synapse + `/.well-known`.
     - `matrix-rtc-320bd4...` → Nginx (`wellknown`) que reenvía a `livekit-jwt` y `livekit`.
     - `call-681f3d...` → frontend Element Call (`element-call-web`).
   - Middleware de redirección HTTPS y CORS (solo se permite `https://element-a05ae4...`).

5. **Element Call frontend**
   - En `element-call/`: configuramos `config/config.organic-machine.json`, copiamos a `public/config.json` y ejecutamos `yarn install`, `yarn build`.
   - El servicio `element-call-web` (Nginx) sirve `element-call/dist` y se expone como `https://call-681f3d.organic-machine.com`.

6. **Element Web**
   - `element-config.json` habilita los labs (`feature_group_calls`, `feature_element_call_video_rooms`, etc.) y define `element_call.url` → `https://call-681f3d...`.
   - Reiniciamos el contenedor para que sirviera el nuevo `config.json`.

7. **CORS y salud**
   - Nginx responde 204 a los preflight y añade las cabeceras `Access-Control-Allow-*`.
   - Traefik refuerza CORS para que solo el origen de Element Web pueda usar `/livekit/jwt` y `/livekit/sfu`.
   - `livekit-jwt` valida tokens OpenID contra Synapse y crea salas vía Twirp en LiveKit.

8. **Dominios implicados**
   - `matrix-af2f3d.organic-machine.com` – Synapse y `.well-known`.
   - `element-a05ae4.organic-machine.com` – Element Web.
   - `admin-0cc4d3.organic-machine.com` – Synapse Admin.
   - `call-681f3d.organic-machine.com` – Element Call frontend.
   - `matrix-rtc-320bd4.organic-machine.com` – LiveKit JWT + SFU.

9. **Diagnóstico rápido**
   - `sudo docker compose -f docker-compose.livekit.yml logs -f livekit-jwt livekit` – tokens y salas.
   - `sudo docker compose logs synapse | grep openid` – emisión de OpenID.
   - DevTools → Network → `livekit/jwt/sfu/get` – debe responder 200 con CORS correcto.

Con todo esto, Element Web usa Element Call (widget) y LiveKit como backend SFU.