Solution communautaire

Comment configurer Jellyfin, Seerr et JellyBridge sur 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 et JellyBridge ne sont pas trois composants d’une seule application ZimaOS. Le fil de discussion de la communauté IceWhale de juin 2026 est devenu plus facile à comprendre une fois la pile séparée en couches : Jellyfin est le serveur multimédia, Seerr est une application autonome de demande de contenus multimédias et JellyBridge est un plugin Jellyfin qui relie les fonctions de découverte et de demande de Jellyfin à Seerr.

L’auteur de la publication d’origine avait déjà Jellyfin en fonctionnement depuis l’App Store de ZimaOS, mais ne parvenait pas à faire fonctionner le reste de la pile. Les réponses de la communauté recommandaient de diagnostiquer chaque couche indépendamment plutôt que de tout modifier en même temps. Un utilisateur a ensuite confirmé que Jellyfin et Seerr fonctionnaient correctement sur un ZimaBoard 2, tandis que sa pile Sonarr/Radarr s’exécutait sur un Raspberry Pi distinct, montrant que ces services n’ont pas besoin de résider dans le même conteneur ni même sur la même machine, tant que les URL, les identifiants d’API et les routes réseau sont corrects.

Comprenez d’abord la pile Jellyfin → Seerr → JellyBridge

La manière la plus simple de comprendre cette configuration est la suivante :

  • Jellyfin : diffuse et gère vos bibliothèques existantes de films et de séries télévisées.
  • Seerr : fournit les fonctions de découverte et de demande de contenus multimédias, puis transmet les demandes approuvées à Sonarr et Radarr.
  • Sonarr/Radarr : gèrent les flux d’acquisition des séries télévisées et des films.
  • JellyBridge : s’exécute dans Jellyfin en tant que plugin et communique avec Seerr afin que la découverte ou l’ajout de favoris dans Jellyfin puisse créer des demandes.

La documentation actuelle de Seerr décrit Seerr comme un gestionnaire de demandes et de découverte de contenus multimédias pour Jellyfin, Plex et Emby, avec une intégration native de Sonarr et Radarr. Seerr s’exécute généralement dans son propre conteneur Docker et expose son interface web sur le port 5055. Consultez le guide actuel de démarrage de Seerr.

Seerr est le successeur actuel de Jellyseerr et d’Overseerr

Une réponse de la communauté signalait que Seerr avait remplacé l’ancienne application Jellyseerr. La documentation actuelle du projet Seerr confirme que Seerr constitue la voie de succession commune pour les utilisateurs de Jellyseerr et d’Overseerr.

C’est important, car d’anciens documents, captures d’écran, variables d’environnement ou noms de conteneurs JellyBridge peuvent encore mentionner Jellyseerr. Le projet JellyBridge actuel indique que Seerr 3.x utilise une API compatible pour l’intégration testée, tout en conservant la terminologie Jellyseerr dans certaines parties de sa documentation.

Si vous construisez cette pile maintenant, commencez par la version actuelle de Seerr plutôt que d’installer volontairement une version obsolète de Jellyseerr, sauf si une version spécifique d’un plug-in l’exige explicitement.

Étape 1 : Faire fonctionner Seerr avant d’installer JellyBridge

Ne cherchez pas à résoudre les problèmes de JellyBridge tant que Seerr lui-même ne fonctionne pas correctement. Installez Seerr comme application Docker ZimaOS distincte ou à l’aide de la source d’application prise en charge par votre système actuel.

Après l’installation, vérifiez directement l’interface web de Seerr :

http://ZIMAOS_LAN_IP:5055

Le port de l’hôte peut être différent si le mappage des conteneurs de votre ZimaOS utilise un autre port externe. Utilisez le port côté hôte indiqué dans les paramètres réels de l’application.

Si Seerr ne s’ouvre pas, vérifiez le conteneur avant de toucher à Jellyfin :

docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100

Ces commandes constituaient les premières vérifications de dépannage suggérées dans le fil de discussion de la communauté. Si les commandes Docker nécessitent des autorisations élevées sur l’hôte dans votre version de ZimaOS, utilisez le processus de terminal autorisé plutôt que d’affaiblir les autorisations du socket Docker.

Étape 2 : Connecter Seerr à Jellyfin

Lors de la configuration de Seerr, configurez Jellyfin avec un compte Jellyfin disposant de droits d’administration. La documentation actuelle de Seerr indique que la page des paramètres Jellyfin gère la connexion au serveur et la synchronisation des bibliothèques.

Vérifiez les éléments suivants avant de continuer :

  • Seerr peut atteindre l’URL Jellyfin que vous avez saisie.
  • Le compte Jellyfin utilisé lors de la configuration dispose des accès administratifs requis.
  • Vos bibliothèques Jellyfin apparaissent dans Seerr après la synchronisation.
  • Une analyse manuelle de la bibliothèque se termine correctement.

Consultez le guide des paramètres du serveur multimédia de Seerr pour connaître la procédure actuelle de connexion à Jellyfin.

Étape 3 : Connecter Seerr à Sonarr et Radarr

Seerr ne télécharge pas lui-même les contenus multimédias. Il envoie les demandes approuvées à Sonarr et Radarr, qui coordonnent ensuite le reste de la pile d’automatisation.

Sonarr et Radarr peuvent fonctionner :

  • sur le même hôte ZimaOS ;
  • dans des conteneurs Docker distincts ;
  • sur un autre serveur domestique ;
  • ou, comme l’a décrit un utilisateur de la communauté, sur un Raspberry Pi distinct.

L’exigence importante est l’accessibilité. Seerr doit utiliser une adresse qui fonctionne depuis le contexte du conteneur Seerr ou de l’hôte. Une URL de navigateur qui fonctionne sur votre ordinateur portable n’est pas automatiquement la bonne adresse pour une communication entre conteneurs.

Ne supposez pas que les conteneurs de l’App Store de ZimaOS partagent le même réseau Docker

L’avertissement réseau le plus utile dans la réponse de la communauté était qu’un conteneur Jellyfin installé depuis l’App Store de ZimaOS peut ne pas détecter automatiquement un conteneur Seerr installé manuellement par son nom.

Si les deux conteneurs se trouvent sur le même réseau Docker défini par l’utilisateur, un nom de service tel que :

http://seerr:5055

peut fonctionner. S’ils se trouvent sur des réseaux Docker différents, utilisez plutôt une adresse d’hôte et un port publié accessibles, par exemple :

http://ZIMAOS_LAN_IP:5055

N’utilisez pas localhost de manière informelle entre les conteneurs. Dans le conteneur Jellyfin, localhost fait référence au conteneur Jellyfin lui-même, et non à un conteneur Seerr distinct.

Étape 4 : Installer JellyBridge dans Jellyfin

JellyBridge est un plugin Jellyfin, et non une autre application ZimaOS destinée à remplacer Jellyfin. La méthode d’installation actuelle du projet recommande d’ajouter son dépôt de plugins via l’interface d’administration de Jellyfin.

Dans Jellyfin :

  1. Ouvrez Tableau de bord > Plugins.
  2. Ouvrez la gestion des dépôts.
  3. Ajoutez l’URL du dépôt du plugin JellyBridge fournie par le projet.
  4. Ouvrez le catalogue des plugins.
  5. Installez la version de JellyBridge correspondant à votre version de Jellyfin.
  6. Redémarrez Jellyfin.

Le dépôt actuel de JellyBridge documente des versions de plugin spécifiques à Jellyfin 10.10 et 10.11. Consultez les notes de compatibilité avant de choisir un paquet. Consultez la documentation du projet JellyBridge.

Étape 5 : Configurer JellyBridge pour accéder à Seerr

Après le redémarrage de Jellyfin, ouvrez la configuration du plugin JellyBridge et fournissez :

  • l’URL Seerr accessible depuis Jellyfin ;
  • la clé API Seerr requise par le plugin ;
  • un répertoire dédié aux données de la bibliothèque JellyBridge ;
  • le comportement de synchronisation que vous souhaitez utiliser.

Utilisez la fonction Tester la connexion du plugin avant d’importer le contenu de découverte. Si le test échoue, ne créez pas encore d’autres bibliothèques. Corrigez d’abord l’URL Seerr, le réseau Docker ou la clé API.

Étape 6 : Créer la bibliothèque de découverte JellyBridge

JellyBridge crée du contenu factice et de découverte que Jellyfin peut afficher sous forme de bibliothèque. La documentation actuelle du plugin inclut une procédure de configuration intégrée au plugin pour générer et configurer cette bibliothèque.

Conservez cette bibliothèque séparée de vos véritables chemins de médias de films et de séries TV. Les éléments de découverte de JellyBridge ne remplacent pas les vrais fichiers gérés par Sonarr, Radarr et Jellyfin.

Lorsque les utilisateurs ajoutent aux favoris des éléments de découverte pris en charge dans Jellyfin, JellyBridge peut envoyer la demande correspondante à Seerr. Seerr gère ensuite l’approbation et transmet la demande à Sonarr ou Radarr selon votre configuration.

L’exemple de la Community ZimaBoard 2

Un participant ultérieur a indiqué qu’il faisait fonctionner Jellyfin et la nouvelle application Seerr ensemble sur un ZimaBoard 2, tandis que sa pile ARR fonctionnait sur un Raspberry Pi 4. Cela constitue un indice utile montrant que l’architecture peut s’étendre sur plusieurs systèmes.

La gamme actuelle pour le matériel ZimaBoard est le serveur monocarte ZimaBoard 2.

La réponse ne fournissait pas les fichiers Docker Compose ni les paramètres réseau exacts de l’utilisateur ; elle ne doit donc pas être considérée comme une configuration vérifiée à copier-coller. Sa valeur est architecturale : les services peuvent être séparés tant que chaque point de terminaison d’intégration est accessible.

Dépannez la pile dans cet ordre

  1. Vérifiez que Jellyfin fonctionne indépendamment.
  2. Vérifiez que le conteneur Seerr reste en fonctionnement.
  3. Ouvrez directement l’interface web de Seerr.
  4. Vérifiez que Seerr peut s’authentifier auprès de Jellyfin et synchroniser les bibliothèques.
  5. Vérifiez que Seerr peut se connecter à Sonarr et Radarr.
  6. Installez la version de JellyBridge compatible avec votre version de Jellyfin.
  7. Vérifiez que JellyBridge peut tester sa connexion à Seerr.
  8. Créez la bibliothèque de découverte JellyBridge uniquement une fois le test de connexion réussi.
  9. Testez une demande depuis Jellyfin et confirmez qu’elle apparaît dans Seerr.
  10. Vérifiez ensuite que Seerr transmet la demande à l’instance Sonarr ou Radarr appropriée.

FAQ sur Jellyfin, Seerr et JellyBridge

Seerr a-t-il besoin de son propre conteneur Docker ?

Oui. Seerr est une application autonome de gestion des demandes. JellyBridge est le plug-in Jellyfin qui communique avec elle.

JellyBridge doit-il apparaître comme une application dans l’App Store de ZimaOS ?

Pas nécessairement. Le projet JellyBridge actuel le distribue sous forme de plug-in Jellyfin installé via le système de dépôt de plug-ins de Jellyfin.

Pourquoi localhost:5055 échoue-t-il depuis JellyBridge ?

Si Jellyfin et Seerr sont des conteneurs distincts, localhost dans Jellyfin renvoie vers le conteneur Jellyfin. Utilisez un nom de service partagé du réseau Docker, ou une adresse d’hôte/IP que le conteneur Jellyfin peut réellement joindre.

Dois-je installer Jellyseerr ou Seerr ?

Pour un nouveau déploiement actuel, Seerr est la voie de remplacement maintenue. La documentation de JellyBridge contient encore la terminologie et les notes de compatibilité de Jellyseerr, car la transition est récente ; vérifiez donc que votre version de JellyBridge est compatible avec la version de Seerr que vous installez.

Sonarr et Radarr peuvent-ils fonctionner sur un autre serveur ?

Oui. Un utilisateur de la communauté a décrit exactement cette configuration. Seerr a seulement besoin d’un accès réseau aux points de terminaison de l’API Sonarr/Radarr et de clés API valides ; les applications n’ont pas besoin de partager le même serveur physique.