openvidu/EASYPANEL-README.md

CONFIGURACIÓN EASYPANEL - OpenVidu Meet

========================================

📋 CONFIGURACIÓN DEL PROYECTO

1. Crear Proyecto en EasyPanel

• Tipo: Docker Compose o Docker Build
• Repositorio: Tu repo con estos archivos
• Branch: main

2. Variables de Entorno Requeridas

# Básicas
NODE_ENV=production
MEET_LOG_LEVEL=info
MEET_BLOB_STORAGE_MODE=memory

# Admin (CAMBIAR)
ADMIN_PASSWORD=tu-password-seguro-aqui

# LiveKit (ajustar según tu setup)
LIVEKIT_URL=wss://tu-livekit-domain.com
LIVEKIT_API_KEY=tu-api-key
LIVEKIT_API_SECRET=tu-secret-32-caracteres-minimo

# Proxy
TRUST_PROXY=true
SERVER_CORS_ORIGIN=*
USE_HTTPS=true

3. Configuración de Puertos

• Opción A (con Nginx): Puerto 80
• Opción B (directo): Puerto 6080

4. Configuración de Dominio

• Agregar tu dominio en EasyPanel
• Habilitar SSL automático
• Configurar redirects HTTP → HTTPS

🐳 OPCIONES DE DEPLOY

Opción A: Con Nginx Proxy (Recomendado)

# Usar docker-compose.yml completo
# Puerto expuesto: 80/443
# Incluye rate limiting y optimizaciones

Opción B: Solo Backend

# Solo el servicio openvidu-meet del compose
# Puerto expuesto: 6080
# EasyPanel maneja el proxy

🔧 CONFIGURACIONES ADICIONALES

LiveKit Setup

1. Desplegar LiveKit en servidor separado
2. Configurar LIVEKIT_URL con dominio público
3. Generar API keys seguros

Redis (Opcional)

• Usar servicio Redis de EasyPanel
• O mantener storage en memoria para simplicidad

SSL/TLS

• EasyPanel maneja certificados automáticamente
• Configurar HTTPS en variables de entorno

🚨 CONSIDERACIONES DE SEGURIDAD

1. Cambiar credenciales por defecto
2. Usar secrets seguros para LiveKit
3. Configurar CORS apropiadamente
4. Habilitar rate limiting
5. Usar HTTPS únicamente

📊 MONITOREO

Health Checks

• /nginx-health - Estado del proxy
• /api/health - Estado del backend
• Logs en EasyPanel dashboard

Métricas

• CPU/Memory usage
• Response times
• Error rates

🔄 ACTUALIZACIONES

1. Push cambios al repo
2. EasyPanel rebuilds automáticamente
3. Zero-downtime deployment

🐛 TROUBLESHOOTING

Backend no arranca

• Verificar variables de entorno
• Revisar logs en EasyPanel
• Verificar puertos

Error de proxy

• Verificar nginx.conf
• Revisar headers
• Verificar upstreams

LiveKit no conecta

• Verificar LIVEKIT_URL
• Verificar API keys
• Verificar connectivity