Saltar al contenido principal

Guía de diagnóstico por integración

Método común​

Para cualquier integración:

  1. Confirma que el servicio externo funciona sin PlexSub.
  2. Confirma que PlexSub puede llegar a la URL desde Docker.
  3. Revisa URL, usuario, API key o token.
  4. Ejecuta diagnóstico en Ajustes > Servicios.
  5. Revisa logs de PlexSub.
  6. Prueba con un usuario de test.

Plex​

Revisa:

  • PLEX_SERVER_URL
  • PLEX_TOKEN
  • Bibliotecas disponibles
  • Conectividad desde Docker
  • Restricción PLEX_ALLOWED_LIBRARIES

Resolución típica:

  • Regenerar token.
  • Corregir URL interna.
  • Validar bibliotecas.

Jellyfin​

Revisa:

  • JELLYFIN_URL
  • JELLYFIN_API_KEY o JELLYFIN_TOKEN
  • Usuarios y bibliotecas
  • Certificado HTTPS si aplica

Resolución típica:

  • Nueva API key.
  • URL accesible desde el contenedor.
  • Validar permisos del usuario/API.

Emby​

Revisa:

  • EMBY_URL
  • EMBY_API_KEY o EMBY_TOKEN
  • Estado experimental del módulo

Resolución típica:

  • Probar primero con un usuario no crítico.
  • Confirmar respuesta directa de Emby.

Seerr, Overseerr y Jellyseerr​

Revisa:

  • OVERSEERR_URL
  • OVERSEERR_API_KEY
  • OVERSEERR_WEBHOOK_SECRET si usas webhooks
  • Coincidencia de usuarios/correos

Resolución típica:

  • Rehacer API key.
  • Revisar webhook.
  • Evitar mezclar Seerr y Peticiones nativas sin política clara.

Radarr y Sonarr​

Revisa:

  • URL del servicio.
  • API key.
  • Perfiles y rutas en el propio Arr.
  • Estado de tareas programadas de PlexSub.

Resolución típica:

  • Corregir perfiles en Arr.
  • Validar identificadores TMDB/TVDB.
  • Reintentar dispatch si el worker falló.

qBittorrent​

Revisa:

  • QBITTORRENT_URL
  • QBITTORRENT_USERNAME
  • QBITTORRENT_PASSWORD
  • Web UI activa

Resolución típica:

  • Confirmar login en Web UI.
  • Revisar firewall y puerto.

Bazarr​

Revisa:

  • BAZARR_URL
  • BAZARR_API_KEY
  • Conexión Bazarr con Radarr/Sonarr.

Resolución típica:

  • Corregir integración Bazarr-Arr.
  • Revisar idiomas y proveedores en Bazarr.

Tautulli​

Revisa:

  • TAUTULLI_URL
  • TAUTULLI_API_KEY
  • Que Tautulli reciba actividad de Plex.

Resolución típica:

  • Validar API key.
  • Revisar mapeo de usuario.

Maintainerr​

Revisa:

  • MAINTAINERR_URL
  • API key si está configurada.
  • Reglas activas en Maintainerr.
  • Dependencia de Plex.

Resolución típica:

  • Validar reglas en Maintainerr antes de exponer resultados a clientes.

Correo SMTP​

Revisa:

  • SMTP_HOST
  • SMTP_PORT
  • SMTP_SECURE
  • SMTP_USER
  • SMTP_PASS
  • SMTP_FROM
  • SMTP_REPLY_TO

Resolución típica:

  • Probar correo de test.
  • Revisar SPF, DKIM y DMARC.
  • Verificar si el proveedor exige contraseña de aplicación.

Pagos​

Revisa:

  • Webhooks.
  • Secretos de verificación.
  • Correo del usuario.
  • Estado en el proveedor real.
  • Estado de suscripción en PlexSub.

Resolución típica:

  • Sincronizar secreto.
  • Reenviar webhook si el proveedor lo permite.
  • Corregir enlace usuario-pago.