mtx
Pila Docker Compose para desplegar un servidor Matrix autoalojado (Tuwunel) con videollamadas grupales nativas vía LiveKit. Incluye proxy inverso Caddy con SSL automático, soporte opcional para Element Web y configuración de delegación sencilla. Requiere Docker Compose v2 y puertos específicos abier
Ficha actualizada 26 sept 2026, 18:54 · upstream 26 sept 2026, 18:43 · release sin release detectada
Qué es mtx
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una pila completa basada en Docker Compose para desplegar un servidor Matrix autoalojado utilizando la implementación Tuwunel, junto con capacidades de videollamadas grupales nativas (Matrix 2.0 / Element Call) a través del SFU de LiveKit. La arquitectura integra Caddy como proxy inverso principal, gestionando el enrutamiento HTTP/WebSocket y la provisión automática de certificados SSL/TLS para todos los servicios expuestos.
El stack soporta opcionalmente el cliente web Element Web mediante un perfil separado, permitiendo una experiencia de usuario completa sin necesidad de instalar clientes de escritorio adicionales. La configuración incluye soporte para delegación de cuentas en dominios raíz distintos del servidor y gestión integrada de TURN servers dentro de LiveKit, todo ello orquestado desde un único archivo docker-compose.yml y variables de entorno centralizadas en .env.
Para el despliegue inicial, es necesario generar claves secretas mediante OpenSSL y configurar registros DNS A apropiados. El sistema está diseñado para entornos con recursos moderados (2 núcleos CPU, 2 GB RAM), facilitando la implementación de infraestructura de mensajería instantánea y comunicación unificada en servidores propios sin complejidad excesiva.
- Videollamadas grupales seguras mediante Element Call integrado con LiveKit
- Despliegue rápido de servidor Matrix federado con autenticación SSL automática
- Configuración de delegación para dominios raíz distintos del servidor Matrix
- Servidor de mensajería unificada (UC) autoalojado ligero
- Soporte opcional para interfaz web Element Web sin instalación extra
- SSL/TLS automático gestionado por Caddy para todos los servicios expuestos
- Integración nativa con LiveKit SFU para videollamadas Matrix 2.0
- Configuración de delegación simplificada para dominios raíz separados
- Soporte opcional para Element Web mediante perfil Docker separado
- Gestión integrada de TURN servers dentro del servicio LiveKit
- Requiere Docker Compose v2 y no soporta versiones anteriores sin actualización
- Necesita generación manual inicial de claves secretas (OpenSSL)
- Dependencia de puertos UDP específicos (3478, 50000-60000) abiertos en firewall
- Requiere al menos 2 núcleos CPU y 2 GB RAM para funcionamiento óptimo
- No incluye scripts de backup automático ni gestión de actualizaciones de imágenes
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Asegurar registros DNS A apuntando al servidor. Abrir puertos TCP 80, 443, 8448 y UDP 3478, 50000-60000 en el firewall. Copiar .env.example a .env, generar claves con OpenSSL (openssl rand -hex 32 para MTX_LIVEKIT_SECRET y -hex 16 para TUWUNEL_REGISTRATION_TOKEN). Configurar LIVEKIT_RTC__NODE_IP con la IP pública. Ejecutar docker compose up -d. Para Element Web, usar --profile web.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.