# 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
```