Solución de la comunidad

Cómo configurar Jellyfin, Seerr y JellyBridge en ZimaOS

A ZimaOS user had Jellyfin running from the App Store but struggled to add Seerr and JellyBridge. Community replies clarified that Seerr is a separate service, JellyBridge is a Jellyfin plugin, and Docker connectivity must be tested layer by layer.

Jellyfin, Seerr y JellyBridge no son tres partes de una sola aplicación de ZimaOS. El hilo de la comunidad de IceWhale de junio de 2026 resultó más fácil de entender una vez que la pila se separó en capas: Jellyfin es el servidor multimedia, Seerr es una aplicación independiente de solicitudes de contenido y JellyBridge es un complemento de Jellyfin que conecta las acciones de descubrimiento y solicitud de Jellyfin con Seerr.

El autor original ya tenía Jellyfin funcionando desde la tienda de aplicaciones de ZimaOS, pero no conseguía que el resto de la pila funcionara. Las respuestas de la comunidad recomendaron diagnosticar cada capa por separado en lugar de cambiarlo todo a la vez. Más tarde, otro usuario confirmó que tenía Jellyfin y Seerr funcionando correctamente en una ZimaBoard 2, mientras que su pila de Sonarr/Radarr se ejecutaba en una Raspberry Pi independiente, lo que demuestra que estos servicios no tienen que estar en el mismo contenedor ni siquiera en la misma máquina, siempre que las URL, las credenciales de API y las rutas de red sean correctas.

Primero, entiende la pila Jellyfin → Seerr → JellyBridge

La forma más sencilla de entender la configuración es la siguiente:

  • Jellyfin: sirve y administra tus bibliotecas existentes de películas y series.
  • Seerr: proporciona descubrimiento y solicitudes de contenido multimedia, y después envía las solicitudes aprobadas a Sonarr y Radarr.
  • Sonarr/Radarr: gestionan los flujos de adquisición de series de televisión y películas.
  • JellyBridge: se ejecuta dentro de Jellyfin como complemento y se comunica con Seerr para que el descubrimiento o los favoritos en Jellyfin puedan crear solicitudes.

La documentación actual de Seerr describe Seerr como un administrador de solicitudes y descubrimiento de contenido multimedia para Jellyfin, Plex y Emby, con integración nativa con Sonarr y Radarr. Normalmente, Seerr se ejecuta en su propio contenedor de Docker y expone su interfaz web en el puerto 5055. Consulta la guía actual de inicio de Seerr.

Seerr es el sucesor actual de Jellyseerr y Overseerr

Una respuesta de la comunidad señaló que Seerr había sustituido a la aplicación Jellyseerr anterior. La documentación actual del proyecto Seerr confirma que Seerr es la vía sucesora conjunta para los usuarios de Jellyseerr y Overseerr.

Esto es importante porque la documentación antigua de JellyBridge, las capturas de pantalla, las variables de entorno o los nombres de los contenedores aún pueden indicar Jellyseerr. El proyecto actual de JellyBridge afirma que Seerr 3.x utiliza una API compatible para la integración que probó, aunque conserva la terminología de Jellyseerr en algunas partes de su documentación.

Si estás creando esta pila ahora, empieza con la versión actual de Seerr en lugar de instalar intencionadamente una versión obsoleta de Jellyseerr, a menos que una versión específica del complemento lo requiera explícitamente.

Paso 1: Haz que Seerr funcione antes de instalar JellyBridge

No soluciones problemas de JellyBridge hasta que el propio Seerr funcione correctamente. Instala Seerr como una aplicación Docker independiente de ZimaOS o utilizando la fuente de aplicaciones compatible disponible en tu sistema actual.

Después de la instalación, verifica directamente la interfaz web de Seerr:

http://ZIMAOS_LAN_IP:5055

El puerto del host puede ser diferente si la asignación de puertos del contenedor en ZimaOS utiliza otro puerto externo. Usa el puerto del host que aparece en la configuración real de la aplicación.

Si Seerr no se abre, comprueba el contenedor antes de modificar Jellyfin:

docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100

Esos comandos fueron las primeras comprobaciones de resolución de problemas sugeridas en el hilo de la comunidad. Si los comandos de Docker requieren permisos elevados en el host de tu versión de ZimaOS, utiliza el flujo de terminal autorizado en lugar de debilitar los permisos del socket de Docker.

Paso 2: Conecta Seerr con Jellyfin

Durante la configuración de Seerr, configura Jellyfin utilizando una cuenta administrativa de Jellyfin. La documentación actual de Seerr indica que la página de configuración de Jellyfin se encarga de la conexión con el servidor y de la sincronización de bibliotecas.

Confirma lo siguiente antes de continuar:

  • Seerr puede acceder a la URL de Jellyfin que introdujiste.
  • La cuenta de Jellyfin utilizada durante la configuración tiene los permisos administrativos necesarios.
  • Tus bibliotecas de Jellyfin aparecen en Seerr después de la sincronización.
  • El análisis manual de la biblioteca se completa correctamente.

Consulta la guía de configuración del servidor multimedia de Seerr para conocer el flujo de conexión actual con Jellyfin.

Paso 3: Conecta Seerr con Sonarr y Radarr

Seerr no descarga contenido multimedia por sí mismo. Envía las solicitudes aprobadas a Sonarr y Radarr, que luego coordinan el resto de la pila de automatización.

Sonarr y Radarr pueden ejecutarse:

  • en el mismo host de ZimaOS;
  • en contenedores de Docker independientes;
  • en otro servidor doméstico;
  • o, como describió un usuario de la comunidad, en una Raspberry Pi independiente.

El requisito importante es la accesibilidad. Seerr debe usar una dirección que funcione desde el contexto del contenedor de Seerr o del host. Una URL del navegador que funciona en tu portátil no es automáticamente la dirección correcta para la comunicación entre contenedores.

No des por hecho que los contenedores de la tienda de aplicaciones de ZimaOS comparten la misma red de Docker

La advertencia de red más útil de la respuesta de la comunidad fue que un contenedor de Jellyfin instalado desde la tienda de aplicaciones de ZimaOS podría no detectar automáticamente por nombre de contenedor un contenedor de Seerr instalado manualmente.

Si ambos contenedores están en la misma red de Docker definida por el usuario, puedes usar un nombre de servicio como:

http://seerr:5055

puede funcionar. Si están en redes de Docker diferentes, usa en su lugar una dirección de host accesible y un puerto publicado, por ejemplo:

http://ZIMAOS_LAN_IP:5055

No uses localhost de forma informal entre contenedores. Dentro del contenedor de Jellyfin, localhost se refiere al propio contenedor de Jellyfin, no a un contenedor de Seerr independiente.

Paso 4: Instalar JellyBridge dentro de Jellyfin

JellyBridge es un complemento de Jellyfin, no otra aplicación de ZimaOS que deba reemplazar a Jellyfin. El método de instalación actual del proyecto recomienda añadir su repositorio de complementos desde la interfaz de administración de Jellyfin.

En Jellyfin:

  1. Abre Panel > Complementos.
  2. Abre la administración de repositorios.
  3. Añade la URL del repositorio del complemento JellyBridge proporcionada por el proyecto.
  4. Abre el catálogo de complementos.
  5. Instala la compilación de JellyBridge que coincida con tu versión de Jellyfin.
  6. Reinicia Jellyfin.

El repositorio actual de JellyBridge documenta compilaciones del complemento específicas para Jellyfin 10.10 y 10.11. Consulta las notas de compatibilidad antes de elegir un paquete. Consulta la documentación del proyecto JellyBridge.

Paso 5: Configurar JellyBridge para acceder a Seerr

Después de que Jellyfin se reinicie, abre la configuración del complemento JellyBridge y proporciona:

  • la URL de Seerr accesible desde Jellyfin;
  • la clave de API de Seerr que requiere el complemento;
  • un directorio dedicado para los datos de la biblioteca de JellyBridge;
  • el comportamiento de sincronización que quieras usar.

Usa la función Probar conexión del complemento antes de importar contenido de descubrimiento. Si la prueba falla, no crees más bibliotecas todavía. Corrige primero la URL de Seerr, la red de Docker o la clave de API.

Paso 6: Crear la biblioteca de descubrimiento de JellyBridge

JellyBridge crea contenido de marcador de posición y de descubrimiento que Jellyfin puede mostrar como una biblioteca. La documentación actual del complemento incluye un flujo de configuración dentro del complemento para generar y configurar esa biblioteca.

Mantén esta biblioteca separada de las rutas reales de tus archivos multimedia de películas y programas de televisión. Los elementos de descubrimiento de JellyBridge no sustituyen a los archivos reales gestionados por Sonarr, Radarr y Jellyfin.

Cuando los usuarios marcan como favoritos elementos de descubrimiento compatibles en Jellyfin, JellyBridge puede enviar la solicitud correspondiente a Seerr. Luego, Seerr gestiona la aprobación y reenvía la solicitud a Sonarr o Radarr según tu configuración.

El ejemplo de la Comunidad ZimaBoard 2

Un participante posterior dijo que tenía Jellyfin y la aplicación Seerr más reciente funcionando juntos en un ZimaBoard 2, mientras que su pila ARR se ejecutaba en una Raspberry Pi 4. Esto constituye una evidencia útil de que la arquitectura puede abarcar varios sistemas.

La opción actual de producto para el hardware ZimaBoard es el servidor de placa única ZimaBoard 2.

La respuesta no proporcionó los archivos exactos de Docker Compose ni la configuración de red del usuario, por lo que no debe considerarse una configuración verificada lista para copiar y pegar. Su valor es arquitectónico: los servicios pueden estar separados siempre que cada punto de integración sea accesible.

Soluciona los problemas de la pila en este orden

  1. Confirma que Jellyfin funcione de forma independiente.
  2. Confirma que el contenedor de Seerr permanezca en ejecución.
  3. Abre directamente la interfaz web de Seerr.
  4. Confirma que Seerr pueda autenticarse en Jellyfin y sincronizar las bibliotecas.
  5. Confirma que Seerr pueda conectarse a Sonarr y Radarr.
  6. Instala la versión de JellyBridge compatible con tu versión de Jellyfin.
  7. Confirma que JellyBridge pueda probar su conexión con Seerr.
  8. Crea la biblioteca de descubrimiento de JellyBridge solo después de que la prueba de conexión se realice correctamente.
  9. Prueba una solicitud desde Jellyfin y confirma que aparezca en Seerr.
  10. Después, verifica que Seerr reenvíe la solicitud a la instancia correcta de Sonarr o Radarr.

Preguntas frecuentes sobre Jellyfin, Seerr y JellyBridge

¿Seerr necesita su propio contenedor Docker?

Sí. Seerr es una aplicación independiente de gestión de solicitudes. JellyBridge es el complemento de Jellyfin que se comunica con ella.

¿Debería aparecer JellyBridge como una aplicación de la tienda de aplicaciones de ZimaOS?

No necesariamente. El proyecto actual de JellyBridge se distribuye como un complemento de Jellyfin instalado mediante el sistema de repositorios de complementos de Jellyfin.

¿Por qué falla localhost:5055 desde JellyBridge?

Si Jellyfin y Seerr son contenedores independientes, localhost dentro de Jellyfin apunta de nuevo al contenedor de Jellyfin. Usa el nombre de servicio de una red Docker compartida o una dirección de host/IP a la que el contenedor de Jellyfin pueda acceder realmente.

¿Debo instalar Jellyseerr o Seerr?

Para una implementación nueva y actual, Seerr es la opción sucesora mantenida. La documentación de JellyBridge todavía contiene terminología y notas de compatibilidad de Jellyseerr porque la transición es reciente, así que verifica que tu versión de JellyBridge sea compatible con la versión de Seerr que instales.

¿Pueden Sonarr y Radarr ejecutarse en otro servidor?

Sí. Un usuario de la comunidad describió exactamente esa configuración. Seerr solo necesita acceso de red a los puntos de conexión de la API de Sonarr/Radarr y claves de API válidas; las aplicaciones no necesitan compartir el mismo servidor físico.