Nick & Tech

Matériel & business · Intermédiaire

Installer Jellyfin sur un Raspberry Pi : ton serveur multimédia maison

Réponse rapide : Installer Jellyfin sur un Raspberry Pi 4 ou 5 se fait en une commande grâce au script officiel install-debuntu.sh, puis en configurant l'interface web sur le port 8096. C'est gratuit et open source, mais attention : le Raspberry Pi 5 n'a plus d'encodeur vidéo matériel, donc le transcodage reste limité. Compte 20 à 30 minutes pour un serveur fonctionnel.

Tu as des films et des séries qui traînent sur un disque dur externe, et tu rêves d'un Netflix maison accessible depuis ton salon, ton téléphone ou même en voyage ? Jellyfin sur Raspberry Pi est l'une des combinaisons les plus populaires pour se monter un serveur multimédia gratuit à la maison. Dans ce guide, on installe Jellyfin pas à pas, on regarde ce que ton Raspberry Pi peut vraiment encaisser côté transcodage, et on évite les pièges classiques des débutants.

Qu'est-ce que Jellyfin et pourquoi l'installer sur un Raspberry Pi ?

En résumé : Jellyfin est un serveur multimédia gratuit et open source, une alternative à Plex sans compte ni abonnement. Sur Raspberry Pi, il tourne en tâche de fond et diffuse tes films, séries et musiques vers tous tes appareils.

Un serveur multimédia, c'est un logiciel qui range ta bibliothèque de vidéos et de musique, puis la diffuse (« stream ») vers tes écrans : télé, téléphone, tablette, navigateur. Jellyfin fait ça sans te demander de compte en ligne ni de carte bancaire.

  • 100 % gratuit et open source : pas d'abonnement premium caché, contrairement à certains concurrents.
  • Consommation électrique très faible : un Raspberry Pi tourne 24h/24 pour quelques euros par mois d'électricité.
  • Compatible avec de nombreux clients : applications mobiles, TV, navigateur web, Kodi.
  • Bonne complémentarité avec un NAS maison : si tu as déjà suivi notre guide complet du NAS sur Raspberry Pi 4, Jellyfin peut venir se greffer sur le même Raspberry Pi ou sur un second boîtier dédié.

Le point à connaître avant de commencer : Jellyfin recommande officiellement de bien choisir son matériel selon l'usage, et met en garde noir sur blanc que <cite index="9-2">"la plupart des SBC (dont le Raspberry Pi, surtout le Raspberry Pi 5) sont trop lents pour offrir une expérience Jellyfin acceptable car ils manquent souvent d'un support correct pour l'accélération matérielle"</cite>. Ce n'est pas rédhibitoire, mais ça oriente tout le reste de cet article.

Comment installer Jellyfin sur un Raspberry Pi étape par étape ?

En résumé : L'installation officielle passe par le script install-debuntu.sh sur Raspberry Pi OS 64 bits, ou par Docker si tu préfères une méthode conteneurisée. Compte 15 à 20 minutes de préparation.

Prérequis avant de commencer :

  • Un Raspberry Pi 4 ou 5, avec Raspberry Pi OS (64 bits) installé et à jour.
  • Une carte micro-SD ou, idéalement, un SSD USB/NVMe pour de meilleures performances (la base de données et les vignettes de Jellyfin détestent les cartes SD lentes).
  • Un disque de stockage séparé pour tes films et séries (disque USB externe ou le NAS que tu as déjà monté).
  • Une connexion Ethernet filaire recommandée plutôt que le Wi-Fi, surtout si plusieurs personnes regardent en même temps.

Étape 1 — Mettre le système à jour

sudo apt update && sudo apt upgrade -y

Étape 2 — Installer Jellyfin via le script officiel

La méthode recommandée par la documentation officielle Jellyfin pour Debian et ses dérivés (dont Raspberry Pi OS) est <cite index="10-1,10-2">"curl -s https://repo.jellyfin.org/install-debuntu.sh -O && curl -s https://repo.jellyfin.org/install-debuntu.sh.sha256sum -O && sha256sum -c install-debuntu.sh.sha256sum"</cite>, ce qui vérifie l'intégrité du script avant de l'exécuter.

curl -s https://repo.jellyfin.org/install-debuntu.sh -O

curl -s https://repo.jellyfin.org/install-debuntu.sh.sha256sum -O

sha256sum -c install-debuntu.sh.sha256sum

sudo bash install-debuntu.sh

Une méthode alternative, manuelle, consiste à ajouter le dépôt APT de Jellyfin toi-même :

sudo apt install apt-transport-https lsb-release curl gnupg

curl https://repo.jellyfin.org/debian/jellyfin_team.gpg.key | gpg --dearmor | sudo tee /usr/share/keyrings/jellyfin-archive-keyring.gpg > /dev/null

echo "deb [signed-by=/usr/share/keyrings/jellyfin-archive-keyring.gpg arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/debian $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

sudo apt update

sudo apt install jellyfin

Étape 3 — Installer via Docker (option pour les habitués des conteneurs)

Si tu es à l'aise avec Docker, la documentation officielle propose aussi une installation en conteneur : <cite index="11-6,11-7,11-8,11-9,11-10,11-11,11-12,11-13,11-14">"docker run -d --name jellyfin --user uid:gid -p 8096:8096/tcp -p 7359:7359/udp --volume /path/to/config:/config --volume /path/to/cache:/cache --mount type=bind,source=/path/to/media,target=/media --restart=unless-stopped jellyfin/jellyfin"</cite>.

mkdir -p /opt/jellyfin/config /opt/jellyfin/cache

docker run -d \

--name jellyfin \

-p 8096:8096/tcp \

-p 7359:7359/udp \

--volume /opt/jellyfin/config:/config \

--volume /opt/jellyfin/cache:/cache \

--mount type=bind,source=/chemin/vers/tes/videos,target=/media \

--restart=unless-stopped \

jellyfin/jellyfin

Étape 4 — Terminer la configuration dans le navigateur

Ouvre http://IP-DE-TON-RASPBERRY:8096 depuis un appareil sur le même réseau, crée ton compte administrateur, puis ajoute ta bibliothèque de médias en pointant vers le dossier où sont rangés tes films et séries.

Bon à savoir : attribue une adresse IP fixe (ou une réservation DHCP) à ton Raspberry Pi avant l'installation, sinon l'adresse peut changer et tu perdras l'accès à l'interface web du jour au lendemain.

Quelles sont les limites de transcodage de Jellyfin sur Raspberry Pi 4 et 5 ?

En résumé : Le transcodage (convertir une vidéo à la volée pour un appareil qui ne la lit pas nativement) est le point faible du Raspberry Pi. Le Pi 5 n'a même plus d'encodeur vidéo matériel du tout.

Le transcodage, c'est quand Jellyfin doit convertir un fichier en temps réel parce que l'appareil qui regarde ne sait pas lire le format d'origine (par exemple un fichier HEVC lu sur un vieux navigateur qui ne comprend que le H.264). C'est l'opération la plus gourmande pour un serveur multimédia.

La documentation officielle de Jellyfin est très claire sur ce point : le support d'accélération matérielle sur Raspberry Pi a été abandonné. <cite index="2-1,2-2,2-3">"Jellyfin supportait auparavant l'accélération matérielle sur Raspberry Pi via OpenMAX OMX dans Jellyfin 10.8, avec un support partiel via V4L2 en 10.9. Cependant, ce support n'a jamais atteint la maturité observée avec les autres méthodes d'accélération. De nombreuses opérations retombaient sur le CPU, déjà peu performant, faute d'accélération matérielle complète."</cite> Et la situation empire avec la dernière génération : <cite index="2-4">"la situation s'est aggravée avec la sortie de la dernière génération de Raspberry Pi 5, qui ne dispose d'aucun encodeur matériel, rendant impraticable tout développement futur de l'accélération matérielle sur cette plateforme"</cite>.

Concrètement, voici ce que chaque modèle peut encaisser :

  • Raspberry Pi 5 : le décodeur matériel HEVC (VideoCore VII) fonctionne, mais l'encodage matériel a été supprimé. Un testeur indépendant confirme que <cite index="4-4,4-5">"le VideoCore VII du Pi 5 peut décoder le HEVC et le VP9 en matériel, mais n'a aucun encodeur vidéo matériel, et le décodage H.264 retombe sur le CPU"</cite>, ce qui limite en pratique à environ deux flux transcodés simultanés en 1080p avant dégradation de la qualité.

La bonne nouvelle : évite le transcodage autant que possible. Configure tes appareils clients (télé, appli mobile) en « Direct Play » : le serveur envoie alors le fichier tel quel, sans conversion, et la charge CPU reste quasiment nulle même sur un Raspberry Pi.

ModèleDécodeur matérielEncodeur matérielTranscodage logiciel réaliste*
Raspberry Pi 4V4L2 (H.264, HEVC)Limité et peu fiable~1 flux 1080p*
Raspberry Pi 5V4L2 (HEVC uniquement)Aucun~1 à 2 flux 1080p*

Quel Raspberry Pi et quel stockage choisir pour Jellyfin ?

En résumé : Le Raspberry Pi 5 avec 4 ou 8 Go de RAM est le meilleur choix en 2026, à condition de rester en Direct Play. Un SSD (USB ou NVMe) améliore nettement la réactivité par rapport à une carte SD.

Si tu hésites encore sur le modèle à acheter, notre article dédié « Quel Raspberry Pi choisir » t'aide à comparer les générations en détail. Pour Jellyfin spécifiquement :

  • Raspberry Pi 4 (4 ou 8 Go) : toujours viable si tu en as déjà un, notamment si tu l'utilises aussi comme NAS maison. Suffisant pour un usage Direct Play avec un ou deux utilisateurs.
  • Stockage système : un SSD externe (USB 3.0) ou NVMe (sur Pi 5 avec HAT dédié) accélère fortement le scan de ta bibliothèque et l'interface, une carte SD classique reste fonctionnelle mais plus lente pour les grosses bibliothèques.
  • Stockage des médias : un disque dur externe dédié, ou le volume de ton NAS existant, séparé du système pour ne pas saturer la carte SD ou le SSD.
Bon à savoir : si tu as vraiment besoin de transcoder plusieurs flux 4K en même temps (par exemple pour toute la famille sur des appareils différents), un mini-PC avec un processeur Intel récent (Quick Sync) sera bien plus adapté qu'un Raspberry Pi. Le Pi reste excellent pour un usage personnel ou en Direct Play.

Foire aux questions

Jellyfin est-il vraiment gratuit sur Raspberry Pi ?

Oui, Jellyfin est un logiciel open source et gratuit, sans version premium ni abonnement caché. Le seul coût réel est celui du matériel (Raspberry Pi, stockage, alimentation) et de l'électricité consommée par le serveur qui tourne en continu.

Le Raspberry Pi 4 est-il meilleur que le Pi 5 pour Jellyfin ?

Non, le Raspberry Pi 5 est plus rapide grâce à son CPU Cortex-A76 à 2,4 GHz, mais aucun des deux modèles n'a d'encodeur vidéo matériel fiable. Dans les deux cas, privilégie le Direct Play plutôt que le transcodage pour de meilleures performances.

Faut-il un disque dur externe pour utiliser Jellyfin sur Raspberry Pi ?

Ce n'est pas obligatoire, mais fortement recommandé : stocker tes films directement sur la carte SD du Raspberry Pi est possible mais peu pratique et risqué à long terme. Un disque externe dédié ou un NAS séparé est plus sûr pour de grandes bibliothèques.

Sources vérifiées

Envie de le voir en vidéo ?

Les tutos pas à pas sont aussi sur Instagram.

Suivre @nickandtech