Saltar al contenido principal

Solución de problemas

Guía rápida para diagnosticar problemas habituales.

La app no abre​

Revisa:

  • El contenedor app está arrancado.
  • El puerto es correcto.
  • La URL coincide con APP_BASE_URL.
  • El proxy inverso apunta al puerto correcto.
  • No hay otro servicio usando el mismo puerto.
docker compose ps

Ver logs​

docker compose logs app --tail 120
docker compose logs db --tail 80

Busca errores repetidos, reinicios o problemas de conexión a PostgreSQL.

Error de base de datos​

Comprueba:

  • PostgreSQL está healthy.
  • POSTGRES_USER, POSTGRES_PASSWORD y POSTGRES_DB coinciden.
  • No has borrado el volumen de base de datos.
  • La app conecta a db:5432 dentro de Docker.
  • No has cambiado de major de PostgreSQL encima del mismo volumen.

No puedo iniciar sesión​

Revisa:

  • Email correcto.
  • Contraseña correcta.
  • Logs de la app.
  • Bloqueo temporal por intentos fallidos.
  • Configuración de sesiones.
  • APP_BASE_URL, HTTPS y TRUST_PROXY_LEVEL si estás detrás de proxy.

En primer arranque, completa la configuración inicial y crea el primer usuario Owner desde el asistente.

Una pantalla sale vacía​

Posibles causas:

  • Servicio externo no configurado.
  • Servicio externo caído.
  • Servicio pausado.
  • Error de permisos.
  • Error frontend.
  • Datos aún no sincronizados.

Revisa logs y prueba recargar.

Un servicio no conecta​

Comprueba:

  • URL correcta.
  • Token o API key correcta.
  • El servicio externo responde fuera de PlexSub.
  • PlexSub puede alcanzar esa URL desde el contenedor.
  • No estás bloqueando redes privadas si necesitas una URL local.

Diagnóstico por integración​

  • Plex: revisa URL, token, bibliotecas permitidas y acceso desde Docker.
  • Jellyfin/Emby: revisa URL, API key/token, usuarios y certificados HTTPS.
  • Seerr/Overseerr/Jellyseerr: revisa URL, API key, webhooks y coincidencia de usuario.
  • Radarr/Sonarr: revisa API key, perfiles, rutas y que el contenido pueda añadirse manualmente.
  • qBittorrent: revisa Web UI, usuario, contraseña y puerto.
  • Bazarr: revisa API key y conexión con Radarr/Sonarr.
  • Tautulli/Tracearr/Jellystat: revisa que el proveedor tenga datos y que el usuario esté mapeado.
  • Maintainerr: revisa reglas activas y dependencia con Plex.
  • SMTP: revisa host, puerto, seguridad, remitente y DNS del dominio.

Problemas con proxy inverso​

Revisa:

  • APP_BASE_URL.
  • HTTPS.
  • Cabeceras proxy.
  • Puerto destino.
  • WebSocket si tu proxy lo requiere.
  • FORCE_SECURE_COOKIES=1 cuando uses HTTPS.

Problemas después de actualizar​

Comprueba:

  • La imagen nueva se descargó.
  • El contenedor app fue recreado.
  • Los volúmenes siguen existiendo.
  • El .env no cambió accidentalmente.
  • Los logs no muestran errores de migración o configuración.

Pérdida de datos​

Si faltan datos:

  • Comprueba si se usó docker compose down -v.
  • Revisa volúmenes.
  • Revisa backups.
  • Revisa si estás en otra carpeta o proyecto Compose.

Qué información preparar al pedir ayuda​

  • Versión aproximada.
  • Método de instalación: Docker, Portainer o Unraid.
  • Qué estabas haciendo.
  • Logs relevantes.
  • Captura sin secretos.
  • Navegador y dispositivo.

No compartas tokens, passwords ni archivos .env completos.