Comment installer Jellyfin sur Raspberry Pi

J’ai toujours voulu avoir un serveur multimédia simple et pas cher que je puisse laisser tourner en permanence. Jellyfin sur un Raspberry Pi semblait être le choix idéal. J’ai dû bidouiller un peu, mais une fois tout bien configuré, ça marche super bien ! Intéressé ? Voici comment faire.

Jellyfin peut être installé via le gestionnaire de paquets APT en ajoutant la prise en charge de HTTPS puis le dépôt Jellyfin. Après cela, le serveur multimédia Jellyfin peut être configuré depuis l’interface web.

Ce tutoriel va aborder le processus d’installation, des instructions de configuration et des conseils pour Jellyfin sur un Raspberry Pi. Avant de commencer le tutoriel, commençons par une brève présentation de Jellyfin.

Si vous débutez avec Raspberry Pi ou Linux, j’ai quelque chose qui peut vous aider !
Téléchargez ma fiche mémo des commandes Linux gratuitement – c’est un guide de référence rapide avec toutes les commandes essentielles dont vous aurez besoin utiliser votre Raspberry Pi. Cliquez ici pour l’obtenir gratuitement !

Qu’est-ce que Jellyfin ?

Jellyfin est un logiciel de serveur multimédia puissant qui permet aux utilisateurs de créer une plateforme de streaming personnalisée, leur permettant de regarder leurs contenus préférés sur plusieurs appareils via un réseau local.

Vous êtes nouveau dans l’hébergement de votre propre serveur multimédia ? Si oui, consultez : Raspberry Pi comme centre multimédia : Guide complet pour débutants !

Ce qui distingue Jellyfin, c’est qu’il n’y a pas de versions payantes ou de modèles d’abonnement. C’est une excellente alternative pour économiser de l’argent par rapport à des options comme Plex et Emby.

Préparons notre Raspberry Pi en tant que serveur multimédia Jellyfin. Nous allons examiner les exigences matérielles et logicielles pour ce tutoriel avant de commencer le tutoriel proprement dit.

Exigences matérielles et logicielles

Voici une liste des éléments nécessaires pour suivre ce tutoriel :

• Raspberry Pi : Je recommande d’utiliser un Raspberry Pi 4 car un serveur multimédia nécessite un CPU assez puissant et plus de mémoire.
• Carte SD : Pour installer la dernière version de Raspberry Pi OS sur notre Pi. Vous aurez besoin d’au moins 8 Go, et vous pouvez trouver mon benchmark de carte SD ici (ou commander la meilleure sur Amazon).
• Disque externe : Cela peut être un SSD (disque à état solide), un HDD (disque dur) ou une clé USB avec une capacité de stockage importante. Ce sera l’endroit où tous les médias seront stockés.

En plus de cela, un réseau local (Wi-Fi ou Ethernet) est nécessaire pour accéder à Jellyfin à distance depuis différents appareils.

Notez que vous aurez besoin d’un Raspberry Pi avec une nouvelle installation de la dernière version de Raspberry Pi OS. Voici un excellent article qui vous aidera : Installer Raspberry Pi OS sur Raspberry Pi (Guide illustré).

Au fait, si vous utilisez Ubuntu sur votre Pi, vous pouvez consulter cet autre article pour les utilisateurs d’Ubuntu : Installer et configurer Jellyfin sur Ubuntu Server (en anglais).

Maintenant que nous avons passé en revue les exigences, commençons le tutoriel.

Installation et configuration de Jellyfin

Voici le processus détaillé pour installer Jellyfin sur votre Raspberry Pi :

• Préparer le Raspberry Pi pour l’installation de Jellyfin.
• Installation de Jellyfin sur le Raspberry Pi.
• Premier accès et configuration initiale de l’interface web de Jellyfin.

Maintenant, examinons chaque étape en détail.

Préparer le Raspberry Pi pour Jellyfin

Dans cette section, nous allons préparer notre Raspberry Pi pour Jellyfin en faisant ce qui suit :

• Ajouter le dépôt Jellyfin pour le paquet apt.
• Monter un périphérique de stockage externe.

Voyons chaque étape en détail maintenant.

Ajouter le dépôt Jellyfin

Dans cette section, nous allons discuter de la façon d’ajouter le dépôt Jellyfin, ce qui nous permet d’installer le paquet logiciel Jellyfin sur notre Raspberry Pi. Nous devrons exécuter quelques commandes dans le terminal pour compléter cela.

La première étape est toujours de mettre à jour les paquets intégrés sur notre Pi à la dernière version. Pour cela, il suffit d’exécuter les commandes suivantes dans le terminal du Pi et de redémarrer votre Pi pour que les changements prennent effet.
sudo apt update
sudo apt upgrade

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Monter automatiquement un disque externe au démarrage

Ensuite, nous voulons désigner un endroit où Jellyfin peut accéder à vos fichiers multimédia stockés localement, comme des films et des séries. Vous pouvez ignorer cette étape pour l’instant et y revenir plus tard si vous n’avez encore rien.

Si vous êtes comme moi, vous stockez tous vos fichiers multimédia sur un disque séparé, comme un disque USB externe ou un stockage en réseau (en anglais). Dans ce cas, vous devrez créer un emplacement de montage statique sur votre système afin que Jellyfin puisse utiliser cet emplacement comme répertoire principal pour les fichiers.

Nous allons configurer un chemin de montage statique « /mnt/jellyfin » pour notre périphérique externe pour ce tutoriel.

Suivez simplement l’un de nos tutoriels en fonction du périphérique de stockage externe que vous utilisez :

• Comment monter un disque USB sur Raspberry Pi
• Comment mapper facilement un disque réseau (en anglais)

Cela complète la configuration requise pour préparer notre Pi pour Jellyfin. Maintenant, nous pouvons procéder au processus d’installation réel de Jellyfin.

Installation de Jellyfin

Maintenant que nous avons préparé notre Raspberry Pi pour Jellyfin, installons-le. Cette section vous montrera comment installer Jellyfin avec une seule commande.

Méthode recommandée : utiliser le script d’installation officiel de Jellyfin

Exécutez la commande suivante dans une nouvelle fenêtre de terminal :
curl https://repo.jellyfin.org/install-debuntu.sh | sudo bash

Cette commande installe la version de Jellyfin spécifique à l’architecture matérielle et logicielle de notre Raspberry Pi. Cela prendra un certain temps car Jellyfin est un paquet assez lourd (environ 100 mégaoctets).

Si tout a été configuré correctement, vous devriez pouvoir installer Jellyfin sans problème. Le service devrait être actif :

C’est tout ! Vous avez installé Jellyfin sur votre Raspberry Pi. Vous pouvez passer à la section sur le premier accès et la configuration initiale. Je vais vous montrer comment accéder à l’interface web de Jellyfin pour la première fois et compléter la configuration initiale.

Méthode alternative : installation manuelle

Si pour une raison quelconque, le script officiel de Jellyfin ne fonctionne toujours pas pour vous, vous pouvez toujours tout installer manuellement. Jellyfin fournit des instructions à ce sujet dans sa documentation officielle.

Correction de l’erreur d’installation /tmp

Remarque : Avez-vous reçu une erreur comme celle-ci lors de l’installation ?
« Espace libre insuffisant pour /tmp : 944968 Ko trouvé, 2097152 Ko requis. Veuillez augmenter la taille de tmpfs ou libérer de l’espace et réessayer. »

Si oui, cette section est pour vous.

Voici comment corriger l’erreur d’installation Jellyfin /tmp sur Raspberry Pi OS :

• Ouvrez le fichier fstab :
  sudo nano /etc/fstab
• Ajoutez cette ligne pour augmenter le dossier /tmp à 4 Go :
  tmpfs /tmp tmpfs defaults,noatime,mode=1777,size=4G 0 0
  
• Enregistrez et quittez (CTRL+X).
• Redémarrez votre système.

Lorsque le système redémarre, vous devriez voir que votre répertoire temporaire est plus grand :
df -h

Maintenant, exécutez à nouveau le script d’installation de Jellyfin.
L’erreur devrait avoir disparu et tout devrait fonctionner comme prévu.

Premier accès et configuration initiale de Jellyfin

Jellyfin fonctionnera par défaut une fois installé.
À la fin de l’installation, vous devriez recevoir des instructions sur la façon d’accéder à l’interface web.

Pour compléter la configuration initiale, ouvrez l’URL suivante depuis un appareil connecté au même réseau que votre Raspberry Pi :
http://<Adresse IP du Raspberry Pi>:8096

Vous pouvez consulter le tutoriel lié pour trouver l’adresse IP actuelle de votre Raspberry Pi.

Une fois l’interface ouverte, suivez ces étapes pour compléter la configuration initiale :

• Sur la page d’accueil de Jellyfin, vous pouvez appuyer sur le bouton Setup Guide pour obtenir plus d’informations sur le processus de configuration.
  

• Maintenant, nous allons simplement passer par le processus de configuration ensemble. Appuyer sur le bouton Next vous amènera à la page de configuration de l’utilisateur. Ici, vous allez configurer un nouveau profil utilisateur, qui aura un contrôle total sur le serveur multimédia. C’est équivalent à créer un utilisateur administrateur.
  
  

• Je vous suggère de définir un mot de passe de base pour plus de sécurité. Une fois tous les champs requis remplis, cliquez sur Next. Il vous sera ensuite demandé de sélectionner une bibliothèque multimédia, qui sera le répertoire principal où tous vos fichiers multimédia seront stockés.
  
  

• Nous avons déjà configuré un chemin de montage statique pour notre périphérique de stockage externe lors de la préparation du Raspberry Pi pour Jellyfin. Cela sera notre bibliothèque multimédia. Il suffit d’appuyer sur le bouton Add Media Library et de sélectionner le type de contenu souhaité et le nom d’affichage.
  
  

• Ensuite, nous allons configurer cette bibliothèque pour pointer vers notre répertoire Jellyfin. Pour cela, appuyez sur le bouton + à côté de Folders et sélectionnez ensuite le répertoire « /mnt/jellyfin » dans la liste des répertoires disponibles et appuyez sur OK.
  
  

• Gardez le reste des options pour Add Media Library par défaut et appuyez sur le bouton OK. Maintenant, vous devriez voir votre bibliothèque nouvellement ajoutée dans le répertoire des bibliothèques. Appuyez sur le bouton Next pour continuer le processus de configuration.
  
  

• Jellyfin maintient les métadonnées de tout le contenu multimédia dans notre bibliothèque locale provenant de divers dépôts en ligne, offrant une expérience utilisateur enrichie. Il nous demande donc de configurer la langue préférée dans laquelle ces métadonnées seront affichées. Configurez-la et cliquez sur Next.
  
  

• Ensuite, nous allons configurer l’accès à distance (accessibilité de l’interface web depuis différents appareils sur le même réseau). Par défaut, les connexions à distance sont autorisées (bien sûr, puisque nous configurons Jellyfin à distance !). Gardez les configurations telles quelles et appuyez sur Next.
  
  

• Cela complète la configuration initiale ! Vous êtes maintenant prêt à utiliser Jellyfin pour regarder vos contenus multimédias préférés !
  
  

Vous devriez maintenant pouvoir accéder à l’interface web de Jellyfin via la même URL après vous être connecté avec l’utilisateur créé. Dans la prochaine section, nous allons passer en revue quelques configurations possibles pour tirer le meilleur parti de notre serveur multimédia.

Cela marque la fin de cette section. Dans la prochaine section, nous allons discuter de quelques configurations supplémentaires que vous pouvez faire pour tirer le meilleur parti de Jellyfin.

Remarque : Si de nouveaux fichiers ajoutés à votre dossier de bibliothèque n’apparaissent pas, vous pouvez forcer un scan dans le menu principal (Administration > Dashboard).

Assurez-vous également que l’utilisateur Jellyfin a les permissions d’accès aux fichiers (en anglais).

Options de configuration avancées de Jellyfin

Cette section discutera des options de configuration supplémentaires disponibles pour un utilisateur afin de tirer le meilleur parti de son serveur multimédia personnel. Nous allons discuter de trois configurations principales :

• Activer l’accélération matérielle pour des performances maximales.
• Sécurité renforcée pour Jellyfin (Activation de HTTPS).
• Comprendre la gestion des utilisateurs dans Jellyfin.

Discutons maintenant de chaque option en détail.

Activer l’accélération matérielle dans Jellyfin

Nous pouvons activer l’accélération matérielle dans Jellyfin afin que le serveur multimédia utilise le GPU du Pi pour une expérience de visionnage supérieure. Pour activer cette option, une configuration supplémentaire est nécessaire. Nous allons couvrir le processus complet dans cette section.

• La première étape est de dire au Raspberry Pi de permettre à l’application Jellyfin d’utiliser le GPU. Pour cela, nous devons l’ajouter au groupe d’utilisateurs vidéo. Nous pouvons le faire en exécutant la commande suivante dans le terminal de notre Raspberry Pi :
  sudo usermod -aG video jellyfin
• Ensuite, nous devons allouer plus de mémoire à notre GPU car l’allocation par défaut de 76 Mo est généralement insuffisante pour des charges de travail plus lourdes comme le décodage vidéo. Pour cela, nous devons apporter des modifications dans le fichier de configuration de démarrage comme suit :
  sudo nano /boot/firmware/config.txt
• Ajoutez la ligne suivante à la fin du fichier et enregistrez le fichier :
  gpu_mem=320
  La quantité de mémoire à définir dépend du modèle de Raspberry Pi que vous utilisez. Je garde 320 Mo pour un Raspberry Pi 4 car il a un GPU beaucoup plus puissant et 160 Mo pour le Raspberry Pi 3 original.
• Enfin, pour que les changements prennent effet, redémarrez votre Raspberry Pi. Une fois cela fait, vous pouvez vérifier la mémoire GPU allouée en utilisant la commande suivante :
  vcgencmd get_mem gpu
• Maintenant que la configuration du GPU pour Raspberry Pi est terminée, nous pouvons activer l’accélération matérielle dans Jellyfin. Pour cela, il suffit d’aller dans l’interface web, d’appuyer sur l’icône de menu située en haut à gauche de l’écran, puis d’appuyer sur l’option Dashboard dans le menu.
  
• Ensuite, allez dans la section Playback dans le menu à gauche, et sous Transcodage, définissez la valeur d’accélération matérielle sur Video4Linux2 (V4L2), qui est le seul mode pris en charge pour le Raspberry Pi.
  

Et voilà, vous avez activé l’accélération matérielle dans Jellyfin !

Sécurité renforcée dans Jellyfin (activation de HTTPS)

La sécurité est un facteur important pour votre serveur multimédia, surtout si vous prévoyez d’y accéder via Internet. Il peut être vulnérable aux cyberattaques s’il n’est pas sécurisé.

Heureusement, Jellyfin permet d’activer le trafic HTTPS. Pour cela, vous aurez besoin d’un certificat SSL qui sera utilisé pour authentifier toutes les connexions à distance entrantes. Le processus est un peu complexe et nécessite des connaissances de base sur le réseau et les commandes bash.

Jellyfin a une page dédiée qui vous guidera tout au long du processus. Elle vous montre comment créer un certificat SSL via Let’s Encrypt, puis il est facile d’ajouter ce certificat via l’interface Jellyfin pour activer HTTPS.

Gestion des utilisateurs dans Jellyfin

Jellyfin permet aux administrateurs de configurer un accès granulaire pour différents utilisateurs sur le serveur multimédia. Cela vous donne des fonctionnalités comme restreindre certains contenus pour vos enfants ou rendre certaines vidéos privées pour un utilisateur particulier.

Il y a un article détaillé dans la documentation de Jellyfin qui explique comment fonctionne la gestion des utilisateurs dans Jellyfin. Il y a une section Users dédiée dans l’interface web de Jellyfin pour gérer ces choses facilement.

Cela marque la fin de ce tutoriel. Maintenant, vous serez capable de :

• Installer et configurer le serveur multimédia Jellyfin sur votre Raspberry Pi.
• Connaître les options de configuration avancées disponibles pour Jellyfin.
• Savoir comment résoudre les problèmes les plus courants rencontrés lors de l’utilisation de Jellyfin.

Si vous souhaitez en savoir plus sur certaines alternatives populaires à Jellyfin, je vous suggère de consulter cet article sur Commencer avec Plex Media Server sur Raspberry Pi.

Questions liées

Cette section couvrira les questions les plus courantes sur l’installation et la configuration de Jellyfin.

Est-il possible d’accéder au serveur multimédia Jellyfin via Internet ?

Oui, vous pouvez configurer votre Raspberry Pi pour qu’il soit accessible via Internet. Une fois cela fait, vous pourrez accéder au serveur Jellyfin via l’adresse IP publique de votre Pi. Voici les étapes nécessaires à la configuration :

• Tout d’abord, vous devez configurer la redirection de port sur votre routeur afin que tout le trafic entrant sur un port spécifique soit redirigé vers le Raspberry Pi. Le processus exact pour configurer la redirection de port dépendra du modèle et du firmware de votre routeur.
• Une fois que vous avez configuré la redirection de port, vous devrez connaître l’adresse IP publique que vous utiliserez pour accéder à l’interface utilisateur de Jellyfin via Internet. Vous pouvez facilement obtenir votre adresse IP publique en visitant ce site web.

Vous devriez pouvoir accéder à votre serveur multimédia sur http://<adresse-ip-publique>:8096. De plus, vous pouvez configurer HTTPS pour une configuration plus sécurisée.

Que faire si je rencontre des problèmes d’accès sur le réseau local ?

Si vous ne parvenez pas à accéder à l’interface web de Jellyfin sur l’un de vos appareils via votre réseau local, cela est probablement dû à des paramètres de pare-feu, des problèmes d’adresse IP ou des problèmes avec le serveur Jellyfin lui-même.

La première chose à vérifier est que l’adresse IP du Raspberry Pi que vous utilisez est correcte. Ensuite, vérifiez que les paramètres du pare-feu autorisent le trafic pour le port 8096 sur lequel Jellyfin fonctionne. Si le problème persiste, il y a un problème avec l’installation de Jellyfin et cela nécessite une enquête plus approfondie.

La solution la plus courante pour ce dernier problème est de mettre à jour Jellyfin vers la dernière version ou de désinstaller et réinstaller une nouvelle instance de Jellyfin.

Que faire si mes fichiers multimédia n’apparaissent pas sur l’interface web de Jellyfin ?

Les scénarios possibles pour ce problème ainsi que leurs solutions sont listés ci-dessous :

• La bibliothèque multimédia n’est pas configurée correctement : Une possibilité est que la bibliothèque multimédia n’ait pas été configurée correctement. Assurez-vous que vous avez configuré les bons chemins. Si un périphérique de stockage externe est connecté, assurez-vous d’avoir créé un chemin de montage statique pour celui-ci.
• Problèmes de permission utilisateur : S’il n’y a pas de problèmes avec le chemin, le problème le plus probable concerne les permissions pour cet utilisateur. Contactez ou utilisez l’utilisateur administrateur pour identifier et résoudre ces problèmes de permission.

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources