Integración Plex

Para qué sirve

Plex es un módulo marcado como obligatorio en el registro de servicios de PlexSub. Se usa para gestionar identidad, acceso, bibliotecas, actividad, historial, descargas y datos visibles en el portal de cliente.

En PlexSub aparece en:

• Admin: /plex-users
• Portal de cliente: estado general, descargas, historial de reproducción y uso

Qué necesitas

• Un servidor Plex accesible desde PlexSub.
• Un token de Plex válido.
• Bibliotecas configuradas en Plex.
• Conectividad desde el contenedor app hacia la URL del servidor Plex.

Variables relacionadas:

• PLEX_SERVER_URL
• PLEX_TOKEN
• PLEX_ALLOWED_LIBRARIES

También puede configurarse desde Ajustes > Servicios si la instalación usa credenciales cifradas en base de datos.

Configuración recomendada

1. Comprueba que Plex funciona fuera de PlexSub.
2. Define la URL que PlexSub debe usar para llegar al servidor.
3. Configura el token con permisos suficientes.
4. Limita bibliotecas si no quieres exponer todo el servidor.
5. Guarda la configuración en PlexSub.
6. Ejecuta el diagnóstico del servicio.

Qué puede fallar

Síntoma	Causa probable	Resolución
Plex aparece como no configurado	Falta URL o token	Revisa Ajustes > Servicios o .env.
PlexSub no conecta	URL inaccesible desde Docker	Prueba conectividad desde el host y revisa red/proxy.
No aparecen bibliotecas	Token insuficiente o bibliotecas no permitidas	Revisa token y PLEX_ALLOWED_LIBRARIES.
Historial o imágenes no cargan	Plex o proveedor de analítica no responde	Revisa Plex, Tracearr/Tautulli y logs de la app.

Privacidad

El token de Plex es sensible. No lo compartas. PlexSub almacena credenciales de servicios cifradas cuando se configuran desde Admin Settings, pero la clave APP_SETTINGS_ENCRYPTION_KEY debe conservarse fuera de Git y fuera de la base de datos.