Jellyseerr : Guide du débutant pour la gestion des médias domestiques

Si vous utilisez Jellyfin, vous savez déjà qu'il est excellent pour héberger et diffuser votre collection de médias. Cependant, certaines parties peuvent être problématiques, comme la gestion des requêtes. C'est là que Jellyseerr intervient. 

Offrant une facilité d'utilisation et des fonctionnalités avancées, Jellyseerr peut amener votre médiathèque à un niveau supérieur. Ce guide vous guide à travers les éléments et la façon d'assurer une intégration transparente pour votre installation.

Table des matières

1. Qu'est-ce que Jellyseerr ?
2. Comment installer Jellyseerr
3. Jellyseerr - Présentation de l'installation de base
4. Configuration avancée
5. Optimiser les performances du Jellyseer
6. Dépannage des problèmes courants
7. Foire Aux Questions
8. Conclusion

1. Qu'est-ce que Jellyseerr ?

Jellyseerr est un outil open-source qui peut faciliter la gestion des requêtes média sur votre serveur Jellyfin. Il fonctionne comme un intermédiaire entre le serveur de médias, les outils d'automatisation et les utilisateurs. Les principales choses qu'il gère sont les demandes, l'approbation et le suivi des médias.

Bien qu'il soit principalement conçu pour Jellyfin, Jellyseerr peut fonctionner avec d'autres serveurs multimédias comme Plex et Emby. Cependant, les développeurs ont averti que certaines fonctionnalités peuvent différer sur d'autres plateformes.

• Gestion des demandes personnalisable : Fonctionnalités avancées pour la demande de médias avec un système de révision et d'approbation facile.
• Manipulation de l'automatisation : L'application peut déclencher des outils populaires tels que Radarr, Sonarr et Prowlarr si nécessaire.
• Notifications : Fournit des mises à jour en temps réel sur le statut de chaque demande. 

Lire aussi : 

• Jellyfin Vs Plex - Bataille des Media Managers
• Les 7 meilleures alternatives à Plex

b. Conditions préalables à l'installation

Avant d'installer Jellyseerr, vérifiez les points suivants :

• Serveur de médias : Jellyfin est installé et fonctionne.
• Outils d'automatisation : Radarr, Sonarr et Prowlarr (pour les indexeurs).
• Base de données : SQLite (Vous pouvez également utiliser PostgreSQL)
• Environnement d'hébergement : NAS / Home Server / Seedbox

2. Comment installer Jellyseerr

Jellyseerr peut fonctionner sur toutes les plateformes qui supportent Jellfin. Bien que les combinaisons soient nombreuses, nous nous concentrerons principalement sur celles qui supportent Docker car c'est le moyen le plus fiable de gérer l'installation. 

Si vous n'êtes pas familier avec Docker, lisez la rubrique RapidSeedbox - Guide de Docker pour les débutants.

a. Option 1 : pour les utilisateurs de NAS

Accédez à votre conteneur Docker sur votre NAS et téléchargez l'image Jellyseer. Vous pouvez le faire en naviguant vers l'onglet "Registry", en recherchant Jellyseer, et en téléchargeant l'image.

Ensuite, créez un conteneur :

Allez dans "Container" et cliquez sur "Create" pour démarrer un nouveau container Jellyseer.

• Définissez les paramètres suivants : 

Cartographie en volume :

• Cartographie des ports :

Faire correspondre un port local (par exemple, 3000) au port 3000 du conteneur.

• Variables d'environnement :

• Démarrer le conteneur.

Vous pouvez maintenant accéder à Jellyseerr en ouvrant votre navigateur et en allant sur http://:3000.

Lire aussi : Les 8 meilleurs NAS Synology pour le multimédia et la synchronisation des fichiers

b. Option 2 : pour les serveurs domestiques Seedbox / Linux

Assurez-vous que votre seedbox supporte Docker (la plupart des fournisseurs le font) et utilisez SSH pour vous connecter. Ensuite, lancez le conteneur Jellyseerr avec ce qui suit :

Remarque : Remplacez /path/to/config par le répertoire de stockage de votre seedbox.

Vous pouvez maintenant utiliser le domaine ou l'IP de votre seedbox et le port (par exemple http://:3000) pour accéder à Jellyseerr. 

Si vous utilisez un serveur domestique Windows, vous pouvez utiliser le même ensemble de commandes. Seule la procédure d'installation de Docker changera.

Lire aussi :

• Faut-il utiliser une boîte à semis ?
• Que fait une boîte à semences ?

Essayez RapidSeedbox dès aujourd'hui !

3. Jellyseerr Basic Setup Walkthrough (en anglais)

Pour utiliser pleinement Jellyseerr, reliez-le à votre serveur Jellyfin. Cela permet à Jellyseerr de gérer les demandes de médias et d'ajouter le contenu approuvé directement à votre bibliothèque.

Ouvrez votre navigateur et accédez à http://:3000 (ou à l'URL équivalente pour votre plateforme). Utilisez les informations d'identification de l'administrateur par défaut créées lors de l'installation. Si vous y êtes invité, créez un mot de passe fort pour le compte administrateur.

Accéder à la page des paramètres :

• Une fois connecté, cliquez sur l'icône de l'engrenage des paramètres dans l'interface de Jellyseerr.
• Naviguez jusqu'à la section Serveur de médias.

Ajouter les détails de Jellyfin :

• Host/IP : Entrez l'adresse IP ou le nom de domaine de votre serveur Jellyfin (par exemple, 192.168.1.100 ou https://myjellyfinserver.com).
• Port : Utilisez le port par défaut (8096 pour HTTP ou 8920 pour HTTPS).
• Clé API: Obtenez-la de Jellyfin en vous connectant à Jellyfin, en allant dans User Settings > API Keys, et en créant une nouvelle clé pour Jellyseerr.
• Cliquez sur Enregistrer pour appliquer les paramètres.

Tester la connexion :

Jellyseerr fournit un bouton "Tester la connexion" pour confirmer la réussite de l'intégration. Cliquez dessus pour vérifier que le serveur est accessible.

a. Ajout de Radarr, Sonarr et Prowlarr

Jellyseerr s'intègre avec des outils d'automatisation comme Radarr, Sonarr, et Prowlarr pour gérer le téléchargement et l'organisation des médias demandés. Dans les paramètres de Jellyseerr, trouvez et ouvrez l'onglet Intégrations.

Ajouter Radarr avec les détails suivants :

• Host/IP : L'adresse IP ou le domaine de votre serveur Radarr (par exemple, http://localhost:7878 ou http://192.168.1.100:7878).
• Clé API : Récupérez-la auprès de Radarr sous Paramètres > Général > Sécurité.
• Cliquez sur Enregistrer et tester la connexion pour vous assurer que la configuration est correcte.

Ajouter Sonarr :

Répétez le processus ci-dessus, mais utilisez son port respectif (par défaut : 8989) et la clé API à partir de Paramètres > Général > Sécurité.

Ajouter Prowlarr (facultatif) :

Si vous utilisez Prowlarr pour gérer les indexeurs, cliquez sur Ajouter une intégration et sélectionnez Prowlarr.

Saisissez l'IP, le port (par défaut : 9696) et la clé API à partir de Paramètres > Général > Sécurité dans Prowlarr.

Lire aussi :

• Guide complet de Radarr - Comment l'installer, l'utiliser, etc.
• Guide Sonarr - Installation, mode d'emploi et plus encore
• Guide Prowlarr : Comment l'installer, le configurer et l'utiliser

4. Configuration avancée

Personnalisez la configuration pour qu'elle corresponde à vos préférences une fois que Jellyseerr est intégré à Jellyfin et à vos outils d'automatisation.

a. Définir les rôles et les autorisations des utilisateurs

• Allez dans la section Gestion des utilisateurs dans les paramètres.
• Créez des comptes d'utilisateurs pour les personnes qui feront des demandes ou géreront les approbations.
• Attribuer des rôles

b. Définir les préférences de qualité par défaut

Dans la section Intégrations, configurez Radarr et Sonarr pour qu'ils donnent la priorité à des qualités spécifiques. Par exemple, vous pouvez configurer Radarr pour qu'il télécharge les films en 4K ou Sonarr pour qu'il préfère les émissions de télévision en HDTV-1080p.

c. Activer les balises et le filtrage

Utilisez des étiquettes pour organiser ou hiérarchiser des demandes spécifiques. Par exemple, attribuez une étiquette "Kids" aux contenus pour enfants ou "4K" aux films de haute qualité. Il est préférable de configurer des filtres pour donner automatiquement la priorité aux demandes comportant des balises spécifiques.

d. Sécurisez votre installation (Important !)

Si votre serveur ou Jellyseerr est accessible depuis l'internet, sécurisez-le en activant HTTPS.

Utilisez un proxy inverse comme Nginx ou Traefik pour gérer les certificats SSL et fournir un domaine personnalisé (par exemple, https://jellyseer.mydomain.com).

Lire aussi : 

• Gestionnaire de proxy Nginx : Comment configurer et utiliser
• Traefik vs NGINX : Comparaison de la conception et des objectifs

5. Optimiser les performances de Jellyseerr

Bien que Jellyseerr soit relativement léger, nous l'exécutons dans des environnements aux ressources généralement faibles. Pour cette raison, il peut devenir lent ou ne pas répondre, se bloquer en cas d'utilisation intensive, ou ne pas traiter les requêtes de manière efficace.

La cause principale réside souvent dans les limites des ressources du système ou dans l'inefficacité de la base de données. Voici comment vous pouvez l'optimiser pour maximiser les performances :

a. Identifier les contraintes en matière de ressources

Un processeur, une mémoire vive ou un espace de stockage limités peuvent entraîner des retards ou des pannes. Allouez des ressources système supplémentaires à Jellyseerr en augmentant les limites de CPU et de mémoire du conteneur Docker :

b. Optimiser la base de données

Jellyseerr utilise SQLite par défaut, ce qui fonctionne bien pour les petites installations mais peut devenir un goulot d'étranglement au fur et à mesure que votre médiathèque et votre base d'utilisateurs grandissent. Pour atténuer ce problème, vous pouvez migrer vers PostgreSQL, qui est plus robuste et évolutif.

• Installez PostgreSQL sur votre serveur ou utilisez un service PostgreSQL basé sur le cloud.
• Mettre à jour la configuration de Jellyseerr pour utiliser PostgreSQL en mettant DB_TYPE=postgresql et en fournissant les détails de connexion.
• Migrer les données existantes de SQLite vers PostgreSQL en utilisant un outil de migration ou la documentation de Jellyseerr.

c. Redémarrer périodiquement le conteneur Docker

Au fil du temps, l'utilisation temporaire des ressources dans le conteneur Docker peut s'accumuler, entraînant une dégradation des performances. Pour y remédier, redémarrez périodiquement le conteneur Docker Jellyseerr afin d'effacer l'utilisation temporaire des ressources :

docker restart jellyseerr

Pour assurer une maintenance régulière, vous pouvez automatiser ce processus à l'aide d'une tâche cron ou du planificateur de tâches Windows.

d. Optimiser les notifications et les mises à jour

Des notifications ou des mises à jour d'état fréquentes peuvent entraîner une charge inutile sur le serveur, en particulier dans les environnements multi-utilisateurs.

• Réduire la fréquence des mises à jour de statut dans les paramètres de Jellyseerr.
• Limitez les notifications aux événements essentiels (par exemple, l'approbation d'une demande ou l'ajout d'un média) afin d'éviter une activité excessive en arrière-plan.

e. Réduire au minimum les plugins ou fonctionnalités inutiles

L'exécution de plugins supplémentaires ou l'activation de fonctions inutilisées peut grever inutilement les performances de Jellyseerr.

• Désactivez les fonctionnalités ou les intégrations que vous n'utilisez pas activement.
• Vérifiez vos paramètres et intégrations Jellyseerr pour rationaliser le flux de travail.

6. Dépannage des problèmes courants

Même avec une installation bien configurée, vous pouvez rencontrer des problèmes lors de l'utilisation de Jellyseerr. Vous trouverez ci-dessous les problèmes les plus courants, leurs causes potentielles et des solutions détaillées pour vous aider à les résoudre efficacement.

a. Jellyseerr ne peut pas se connecter à Jellyfin

Si Jellyseerr ne peut pas se connecter à votre serveur Jellyfin, vous pouvez remarquer que les requêtes ne sont pas traitées ou que les détails des médias ne peuvent pas être récupérés. 

Ce problème est généralement causé par des détails de serveur incorrects entrés dans Jellyseerr, tels qu'une adresse IP, un numéro de port ou une clé API invalide. Des restrictions réseau, telles qu'un pare-feu bloquant la communication entre Jellyseerr et Jellyfin, peuvent également être à l'origine du problème.

Solutions possibles :

• Vérifiez l'adresse IP ou le domaine de Jellyfin, le port (8096 pour HTTP ou 8920 pour HTTPS), et la clé API dans les paramètres de Jellyseerr.
• Régénérez la clé API dans Jellyfin sous Paramètres utilisateur > Clés API si nécessaire.
• Assurez-vous qu'aucune règle de pare-feu ne bloque l'accès. Vous pouvez le faire en testant la connexion à l'aide d'une commande telle que :

b. Demandes ne figurant pas dans Radarr/Sonarr

Lorsque les demandes approuvées n'apparaissent pas dans Radarr ou Sonarr, cela est souvent dû à des paramètres d'intégration incorrects dans Jellyseerr. Il peut s'agir d'URLs invalides, de ports erronés ou de clés d'API mal adaptées. 

Une autre cause fréquente est que le serveur Jellyseerr ne peut pas atteindre Radarr ou Sonarr en raison de restrictions de réseau ou d'une mauvaise configuration.

Solutions possibles :

• Vérifiez les URL pour Radarr et Sonarr dans les paramètres de Jellyseerr. Par exemple, utilisez http://:7878 ou http://:8989.
• Confirmez les clés API en les récupérant dans Paramètres > Général > Sécurité dans Radarr et Sonarr.
• Testez la connexion dans l'onglet intégrations de Jellyseerr pour vous assurer que tout est configuré correctement.

c. Les médias ne se téléchargent pas

Si les demandes approuvées apparaissent dans Radarr ou Sonarr mais que les téléchargements ne démarrent pas, le problème réside souvent dans la configuration du client de téléchargement ou des indexeurs. Un client de téléchargement mal configuré, tel que qBittorrent ou Transmission, peut ne pas être connecté correctement. 

Par ailleurs, des indexeurs manquants ou mal configurés dans Radarr ou Sonarr peuvent ne pas trouver le contenu demandé.

Solutions possibles :

• Assurez-vous que le client de téléchargement est ajouté correctement dans Radarr/Sonarr avec l'adresse IP, le port et la clé API appropriés.
• Testez les indexeurs dans Radarr ou Sonarr en recherchant manuellement le contenu demandé.
• Vérifiez les journaux dans Radarr ou Sonarr pour toute erreur liée aux téléchargements ou aux connexions à l'indexeur.

d. Les médias ne s'affichent pas dans Jellyfin

Si le contenu téléchargé n'apparaît pas dans votre bibliothèque Jellyfin, cela est généralement dû à des chemins d'accès incorrects ou à un retard dans l'analyse de la bibliothèque. Les chemins d'accès à la bibliothèque dans Jellyfin peuvent ne pas correspondre à l'emplacement de téléchargement de Radarr ou Sonarr, ou Jellyfin peut ne pas scanner la bibliothèque assez fréquemment. 

La non-concordance des métadonnées peut également empêcher l'affichage correct du contenu.

Solutions possibles :

• Vérifier que les chemins d'accès aux bibliothèques de Jellyfin sont correctement configurés pour correspondre aux répertoires de téléchargement utilisés par Radarr et Sonarr.
• Déclenchez manuellement un scan de bibliothèque dans Jellyfin en naviguant vers Tableau de bord > Bibliothèques et en sélectionnant Scanner les fichiers de la bibliothèque.
• Utiliser le gestionnaire de métadonnées de Jellyfin pour vérifier et mettre à jour les métadonnées des médias manquants.

e. L'interface web de Jellyseerr ne se charge pas

Si vous ne pouvez pas accéder à l'interface web de Jellyseerr, il se peut que le conteneur ne fonctionne pas, ou que le mappage de port dans votre configuration Docker soit incorrect. Ce problème peut également survenir si un proxy inverse est mal configuré ou si les certificats SSL sont mal configurés pour l'accès HTTPS.

Solutions possibles :

• Vérifiez l'état du conteneur Docker Jellyseerr en utilisant la commande : 

• Redémarrer le conteneur s'il est arrêté :

docker restart jellyseerr

• Assurez-vous que votre configuration Docker ou NAS mappe le port correct (par défaut : 3000).
• Vérifiez le certificat SSL et les paramètres du proxy si vous utilisez HTTPS avec un proxy inverse.

f. Les notifications ne fonctionnent pas

Lorsque les utilisateurs ne reçoivent pas de notifications sur les mises à jour des requêtes, c'est souvent parce que les paramètres de notification dans Jellyseerr n'ont pas été configurés ou que le service de notification choisi (par exemple, email ou push) est mal configuré. 

Cela peut également se produire si le service de notification ne dispose pas des informations d'identification ou des paramètres de connexion appropriés.

Solutions possibles :

• Allez dans Paramètres > Notifications dans Jellyseerr et configurez le service de notification (par exemple, email ou service de notification push).
• Tester le système de notification en déclenchant une demande de mise à jour.
• Recherchez dans les journaux les erreurs liées à la configuration du service de notification.

7. Questions fréquemment posées

8. Conclusion

Si vous ne l'avez pas encore fait, c'est le moment d'installer Jellyseerr et d'expérimenter ses avantages. Rationalisez votre gestion des médias, améliorez votre expérience de Jellyfin, et gardez vos utilisateurs heureux avec cet outil ultime de demande de médias.

Ceux qui gèrent pour la première fois une collection de médias devraient commencer à apprendre à utiliser Jellyseerr très tôt. Vous n'imaginez pas à quelle vitesse votre collection peut grandir et devenir incontrôlable. 

Obtenez RapidSeedbox maintenant !