Vous avez vu à quel point il est simple de configurer Plex sur votre NAS, et vous pouvez vouloir découvrir son alternative open source puissante, Jellyfin — un serveur multimédia qui offre un contrôle total des données sans aucun frais d’abonnement. Dans ce guide, nous allons non seulement présenter les principaux avantages de Jellyfin, mais aussi fournir une procédure claire et détaillée, étape par étape, pour l’installer sur votre NAS UGREEN.

Application simple vs Docker avancé

Il existe deux méthodes simples pour installer Jellyfin sur votre NAS UGREEN. Pour la plupart des utilisateurs, en particulier ceux qui découvrent les serveurs multimédias, il est recommandé de commencer par l’application Container depuis l’App Store — elle est conçue pour la simplicité et une mise en place rapide. Si vous êtes un utilisateur avancé ayant besoin de plus de flexibilité, de configurations personnalisées ou d’un accès aux toutes dernières fonctionnalités, la méthode Docker vous offre un contrôle total. Des guides complets et détaillés pour les deux approches sont fournis ci-dessous.

Méthode 1 : installation via l’application simple (recommandée pour les débutants)

Voici la méthode directe pour installer Jellyfin depuis l’App Center :

1. Installer Jellyfin : ouvrez l’Centre d'applications, recherchez l’application Jellyfin et cliquez sur « Installer ».
2. Sélectionner le stockage : choisissez le volume de stockage sur lequel vous souhaitez installer Jellyfin, puis cliquez sur « Suivant » pour continuer.
3. Définir le chemin des médias : configurez le chemin d’accès aux ressources. Jellyfin analysera cet emplacement pour trouver vos fichiers multimédias et récupérera automatiquement les affiches et métadonnées.
4. Définir le chemin des plugins (optionnel) : configurez le chemin des plugins si vous prévoyez d’utiliser des plugins personnalisés, puis cliquez sur « Installer » pour poursuivre.

Configuration initiale de Jellyfin

Lors de la première ouverture de Jellyfin, un assistant de configuration rapide doit être complété :

1. Définir la langue d’affichage : choisissez votre langue préférée (par exemple « Français »), puis cliquez sur « Next ».
2. Créer un compte administrateur : définissez un nom d’utilisateur et un mot de passe pour le compte administrateur, puis cliquez sur « Next ».
3. Ignorer la configuration de la médiathèque : vous pouvez ignorer l’ajout des bibliothèques multimédias lors de cette configuration initiale. Cliquez simplement sur « Next » pour continuer.
4. Définir la langue préférée : configurez la langue préférée pour les métadonnées (cela détermine la manière dont Jellyfin récupère les informations sur les films et séries).
5. Configurer l’accès à distance : conservez les paramètres par défaut affichés (cela garantit un fonctionnement optimal), puis cliquez sur « Next ».
6. Finaliser la configuration : cliquez sur « Finish » pour terminer la configuration initiale.

Vous pouvez maintenant vous connecter à votre serveur Jellyfin à l’aide du compte administrateur que vous venez de créer.

Ajouter votre médiathèque

Après connexion, suivez ces étapes pour ajouter votre médiathèque :

1. Sur l’interface principale de Jellyfin, cliquez sur le bouton « Management Menu » dans le coin supérieur gauche. Dans le panneau latéral déployé, cliquez sur « Dashboard » pour accéder à la page.
2. Dans le Dashboard, allez dans Libraries > Media Libraries et cliquez sur « Add Media Library ».
3. Choisissez le type de contenu approprié (par exemple « Movies » ou « TV Shows ») pour votre collection multimédia.

Méthode 2 : Docker avancé (configuration et gestion flexibles)

Pour les utilisateurs qui doivent déployer et gérer rapidement plusieurs conteneurs, l’utilisation de Docker Compose est recommandée. Cette méthode permet d’orchestrer l’ensemble de votre application multi-conteneurs à partir d’un seul fichier de configuration unifié.

Configurer le fichier Docker Compose

Ouvrez l’application Docker, cliquez sur [Project] > [Create] pour lancer l’assistant de création de projet. Lors de la création d’un projet, vous devez fournir un fichier de configuration Docker Compose :

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: always
    devices:
      - /dev/dri:/dev/dri  # Integrated graphics
    environment:
      PUID: 0
      PGID: 0
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /volume2/video:/video2 #Library location
    ports:
      - 9096:8096/TCP
    network_mode: "bridge"

Explication des paramètres

• image : nyanmisaka/jellyfin:latest indique la dernière version de l’image du serveur Jellyfin.
• container_name : définit un nom spécifique pour le conteneur jellyfin afin de faciliter la gestion.
• restart : always signifie que le conteneur redémarre automatiquement s’il s’arrête de manière inattendue.
• devices : /dev/dri:/dev/dri monte le périphérique /dev/dri de l’hôte dans le conteneur pour l’accélération matérielle, comme le transcodage vidéo.

environment :

Définit les variables d’environnement pour configurer les services dans le conteneur.

• PUID: 0 : définit l’identifiant utilisateur à l’intérieur du conteneur ; 0 signifie une exécution avec des privilèges root.
• PGID: 0 : définit l’identifiant de groupe ; 0 correspond au groupe root.

volumes :

• Fonction : monte des chemins de dossiers locaux dans le conteneur afin d’assurer la persistance des données.
• ./config : ./ représente le répertoire dans lequel se trouve le fichier Docker Compose actuel. Le dossier config de ce répertoire est monté sur le répertoire /config dans le conteneur, utilisé pour stocker les fichiers de configuration de Jellyfin. Cela garantit que les données de configuration ne sont pas perdues même si le conteneur est redémarré ou recréé.
• ./cache : le dossier cache du répertoire courant est monté sur le répertoire /cache dans le conteneur, utilisé pour stocker le cache de Jellyfin.
• /volume2/video:/video2 : le dossier /volume2/video du NAS est monté sur le répertoire /video2 dans le conteneur et sert de répertoire source pour la bibliothèque. Le chemin avant les deux-points correspond au chemin sur le NAS, et celui après correspond au chemin dans Docker, qui est celui à saisir lors de la configuration de Jellyfin. Vous pouvez remplacer /volume2/video par d’autres chemins de dossiers sur le NAS selon vos besoins réels.

ports :

• 8096:8096/TCP : mappe le port 8096 du conteneur (protocole TCP) vers le port 9096 sur le NAS UGREEN. Il est utilisé pour l’interface web de gestion Jellyfin, destinée à la gestion des bibliothèques et aux opérations de lecture.

network_mode :

• bridge : définit le mode réseau du conteneur en mode bridge.
• Fonction : le mode bridge permet au conteneur de partager le réseau avec l’hôte et d’être accessible via l’adresse IP de l’hôte. Le conteneur fournit ainsi des services via les ports mappés et peut communiquer avec d’autres appareils du même réseau.

Configuration initiale de Jellyfin

Maintenant que Jellyfin est en cours d’exécution, il est temps de le configurer.

1. Ouvrez un nouvel onglet de navigateur web et accédez à http://[YOUR-NAS-IP]:9096, en remplaçant [YOUR-NAS-IP] par l’adresse IP de votre NAS UGREEN.
2. L’assistant de configuration Jellyfin s’affiche. Suivez les instructions à l’écran :
• Choisissez votre langue préférée.
• Créez un compte administrateur avec un nom d’utilisateur et un mot de passe sécurisés.
• Ajoutez vos bibliothèques multimédias. Cliquez sur Add Media Library, sélectionnez le type de contenu (par exemple Movies) et, pour le dossier, ajoutez le chemin depuis l’intérieur du conteneur, qui est /video dans cette configuration.
• Sélectionnez votre langue et votre pays préférés pour la récupération des métadonnées.
• Configurez les paramètres d’accès à distance si vous prévoyez de diffuser en dehors de votre réseau domestique.
3. Une fois l’assistant terminé, connectez-vous avec vos nouveaux identifiants pour confirmer que tout fonctionne correctement.

Activer le transcodage matériel

Pour aller plus loin, vérifiez aussi que votre modèle dispose des ressources nécessaires (CPU/GPU, mémoire, connectivité) pour tirer pleinement parti du transcodage matériel sur des flux 4K. Vous trouverez un aperçu des options disponibles dans la gamme de NAS et serveurs, afin de choisir une configuration adaptée à votre usage multimédia.

Activer le transcodage matériel sur les appareils de la série DXP

Activez le transcodage matériel avec accélération matérielle (Intel QuickSync - QSV). Dans le menu de gauche de la console, cliquez sur [Playback] > [Transcoding].

• Accélération matérielle : sélectionnez Intel QuickSync (QSV).
• Périphérique QSV : saisissez le chemin /dev/dri/renderD128.
• Activer le décodage matériel : cochez tous les formats de codecs pris en charge.

Une fois les paramètres définis, faites défiler jusqu’en bas de la page et cliquez sur « Save ».

Activer le transcodage matériel sur les appareils de la série DH

Les appareils de la série DH reposent sur une architecture ARM et intègrent un VPU (Video Processing Unit) pour prendre en charge l’accélération matérielle vidéo. Lors de la lecture de vidéos avec Jellyfin, il est possible d’activer le transcodage matériel en utilisant le VPU afin d’améliorer les performances.

1. Dans le menu de gauche du tableau de bord, cliquez sur [Playback] > [Transcoding].
2. Pour l’accélération matérielle, sélectionnez Rockchip MPP (RKMPP).
3. Cochez tous les formats d’encodage pris en charge.
4. Après configuration, cliquez sur le bouton « Save » en bas de la page.

Dépannage des problèmes courants de configuration Jellyfin

En cas de difficulté, voici quelques solutions fréquentes :

• Les médias n’apparaissent pas ? Il s’agit généralement d’un problème de mappage de dossiers. Revenez dans les paramètres du conteneur Docker et vérifiez soigneusement les « Volume Settings ». Le « Host Path » de vos médias doit correspondre exactement à l’emplacement de vos dossiers sur le NAS.
• Échec de connexion ? Vérifiez à nouveau votre nom d’utilisateur et votre mot de passe. En cas d’oubli, il peut être nécessaire de supprimer le conteneur et le dossier de configuration créé, puis de recommencer.
• Le transcodage ne fonctionne pas ? Commencez par confirmer que votre NAS UGREEN dispose d’un processeur Intel compatible avec Quick Sync. Ensuite, retournez dans le Dashboard Jellyfin et vérifiez que « Intel QuickSync (QSV) » est bien sélectionné comme méthode d’accélération matérielle.
• Impossible d’accéder à la page web Jellyfin ? Il s’agit probablement d’un conflit de ports. Vérifiez si un autre service sur votre NAS utilise déjà le port 9096. Vous pouvez facilement le modifier dans les « Port Settings » de votre conteneur Docker en changeant le « Host Port » pour une autre valeur, par exemple 8097.