99 lines
2.4 KiB
Markdown
99 lines
2.4 KiB
Markdown
# Matrix + Element + Synapse Admin - Docker Setup
|
|
|
|
Configuración completa de servidor Matrix con Element Web y panel de administración usando Docker Compose.
|
|
|
|
> **CI/CD**: push a Gitea → webhook → deploy_server → `docker compose pull` + `up -d`.
|
|
|
|
## 🚀 Servicios incluidos
|
|
|
|
- **Matrix Synapse**: Servidor Matrix (puerto 8008)
|
|
- **Element Web**: Cliente web (puerto 8081)
|
|
- **Synapse Admin**: Panel de administración (puerto 8082)
|
|
- **PostgreSQL**: Base de datos (puerto 5432)
|
|
|
|
## 📋 Requisitos previos
|
|
|
|
- Docker y Docker Compose instalados
|
|
- Puertos 8008, 8081, 8082, 5432 disponibles
|
|
|
|
## ⚡ Inicio rápido
|
|
|
|
1. **Clonar repositorio**:
|
|
```bash
|
|
git clone <tu-repo>
|
|
cd element_matrix_chat
|
|
```
|
|
|
|
2. **Configurar variables de entorno**:
|
|
```bash
|
|
cp .env.example .env
|
|
# Editar .env con tus configuraciones
|
|
```
|
|
|
|
3. **Ejecutar setup**:
|
|
```bash
|
|
./scripts/setup.sh
|
|
```
|
|
|
|
4. **Iniciar servicios**:
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
## 🔐 Acceso por defecto
|
|
|
|
- **Element Web**: http://localhost:8081
|
|
- **Synapse Admin**: http://localhost:8082
|
|
- **Usuario admin**: `admin` / `admin123`
|
|
|
|
## 📁 Estructura del proyecto
|
|
|
|
```
|
|
element_matrix_chat/
|
|
├── docker-compose.yml # Configuración Docker
|
|
├── element-config.json # Config Element Web
|
|
├── configs/ # Plantillas de configuración
|
|
├── scripts/ # Scripts de utilidad
|
|
└── README.md # Esta documentación
|
|
```
|
|
|
|
## 🛠️ Scripts disponibles
|
|
|
|
- `./scripts/setup.sh`: Configuración inicial
|
|
- `./scripts/create-user.sh`: Crear usuarios
|
|
- `./scripts/backup.sh`: Backup de datos
|
|
|
|
## ✨ Características habilitadas
|
|
|
|
- ✅ Búsqueda de usuarios
|
|
- ✅ Directorio de salas públicas
|
|
- ✅ Registro de usuarios habilitado
|
|
- ✅ Panel de administración web
|
|
- ✅ Persistencia de datos
|
|
|
|
## 📞 Element Call + LiveKit
|
|
|
|
Si quieres habilitar llamadas con Element Call y su backend LiveKit, revisa la
|
|
[guía específica](docs/element-call-livekit.md). Explica cómo:
|
|
|
|
- Ajustar Synapse para MatrixRTC
|
|
- Generar la configuración de LiveKit
|
|
- Ejecutar los contenedores `livekit` y `livekit-jwt`
|
|
- Publicar el `.well-known` y el frontend (opcional)
|
|
|
|
## 📖 Documentación adicional
|
|
|
|
Consulta la [documentación oficial de Matrix](https://matrix.org/docs/) para configuraciones avanzadas.
|
|
|
|
## 🔧 Troubleshooting
|
|
|
|
Ver logs:
|
|
```bash
|
|
docker-compose logs [servicio]
|
|
```
|
|
|
|
Reiniciar servicios:
|
|
```bash
|
|
docker-compose restart
|
|
```
|