Installer Jellyfin sur Synology : la liberté open source
Guide complet pour installer Jellyfin en Docker sur NAS Synology. L'alternative 100% gratuite et open source à Plex. Bibliothèques, utilisateurs, apps clients, accès distant.
Ce guide a un but éducatif. Jellyfin est un logiciel libre et gratuit, fork d'Emby. monratio.fr n'encourage en aucun cas le piratage ou le téléchargement illégal de contenus protégés par le droit d'auteur. Jellyfin sert à organiser et lire vos propres fichiers médias.
🎬 Pourquoi Jellyfin (et pas Plex)
Jellyfin et Plex font la même chose : ils transforment votre NAS en Netflix personnel. Vous ajoutez vos films/séries, ils génèrent les jaquettes, les descriptions, les sous-titres, et streament tout sur votre TV/téléphone.
La différence principale : Jellyfin est 100% open source et gratuit, sans aucune fonctionnalité bloquée derrière un abonnement. Plex demande un compte plex.tv (cloud) et bloque certaines features (HW transcoding, mobile sync) derrière le Plex Pass à 5$/mois.
Jellyfin vs Plex : les vraies différences
Quand choisir Jellyfin :
- Vous voulez du 100% gratuit pour toujours, sans paywall
- Vous êtes anti-cloud et anti-tracking
- Vous aimez le logiciel libre par principe
- Votre setup est local (pas trop besoin d'accès distant facile)
- Vous regardez surtout sur PC/téléphone (où les apps Jellyfin sont excellentes)
Quand préférer Plex :
- Vous regardez beaucoup sur Smart TV (les apps Plex sont partout)
- Vous voulez la solution la plus polie et user-friendly pour la famille
- Vous voulez l'accès distant en 1 clic (Plex Relay)
- Voir notre tuto Plex si vous hésitez
Jellyfin : fork open source d'Emby (qui est devenu propriétaire en 2018). GPL-2, pas de telemetry, pas de compte cloud, pas de paywall. Hardware transcoding gratuit (vs Plex Pass à 5$/mois). Apps natives Android/iOS/Roku/FireStick excellentes. Apps Smart TV (Samsung Tizen, LG webOS) en progression mais moins matures qu'Emby/Plex. Pour Apple TV : tvOS app community-maintained (Swiftfin) très bonne.
L'histoire courte de Jellyfin Jellyfin est né en 2018 quand Emby (qui était open source) est devenu propriétaire. Une partie de la communauté a forké la dernière version libre et créé Jellyfin. Depuis, le projet est maintenu par des bénévoles avec une vraie philosophie : pas de tracking, pas de monétisation, pas de cloud forcé. C'est devenu le choix par défaut des amateurs de logiciel libre et de privacy.
Et Emby alors ? Emby existe toujours, en mode freemium (Emby Premiere à 5$/mois). C'est entre Jellyfin et Plex en termes de polish. Mais Emby ne progresse plus aussi vite que Jellyfin côté communauté. Pour 2026, les vrais choix se résument à Jellyfin (libre) ou Plex (poli).
📋 Vérifier les prérequis
Avant d'installer Jellyfin, on s'assure que tout est prêt sur votre Synology.
Prérequis #1 : Container Manager (Docker)
Comme pour les autres tutos *arr, on utilise Docker. C'est plus propre et plus facile à mettre à jour qu'un paquet community.
- Ouvrez Centre de paquets
- Vérifiez que Container Manager (DSM 7) ou Docker (DSM 6) est installé
Prérequis #2 : NAS Synology adapté
- Minimum : DS220+ avec 2 Go RAM. Streaming SD/720p direct play sans souci.
- Recommandé : DS920+ ou DS923+ avec 4-8 Go RAM. Streaming 1080p/4K avec transcoding GPU si besoin.
- À éviter : modèles Realtek (DS218j, DS220j) qui peinent dès qu'il faut transcoder.
Prérequis #3 : Vos médias bien organisés
Jellyfin (comme Plex) marche mieux quand vos fichiers sont nommés correctement. Si vous utilisez Sonarr et Radarr, c'est déjà fait. Sinon, voici la convention :
Structure recommandée :
/volume1/data/
├── films/
│ ├── Inception (2010)/
│ │ └── Inception (2010).mkv
│ └── Le Seigneur des Anneaux (2001)/
│ └── Le Seigneur des Anneaux (2001).mkv
└── series/
└── Better Call Saul/
├── Season 01/
│ ├── S01E01.mkv
│ └── S01E02.mkv
└── Season 02/
└── ...Si votre nommage est plus chaotique, Jellyfin essaiera quand même mais vous aurez plus de fichiers mal identifiés.
Prérequis #4 : Dossier de config
Créez un sous-dossier jellyfin/ dans /volume1/docker/ pour stocker la base de données et les caches.
Conseil : si vous avez Plex installé en parallèle, ne mélangez pas les bibliothèques. Jellyfin n'utilise pas la même base de données que Plex, donc les statistiques de visionnage ne sont pas partagées. Vous pouvez tout à fait avoir les deux pour comparer pendant 1-2 semaines.
Prérequis : Docker (Container Manager DSM 7), Synology x86 ou ARM64. Hardware transcoding nécessite un proco Intel récent (DS920+ et plus, Quick Sync) ou un GPU NVIDIA. Sur Synology Realtek : direct play seulement. Pour les NAS DSM 6 ou anciens : version Linuxserver Jellyfin compatible. Conventions de nommage : voir jellyfin.org/docs.
Hardware transcoding sur Synology : Jellyfin supporte Intel Quick Sync (QSV) et VAAPI sur les NAS Intel récents (DS920+, DS923+, DS923+, etc.). C'est gratuit (contrairement à Plex Pass). Vous pouvez transcoder du 4K HEVC vers 1080p H.264 en temps réel pour un téléphone qui ne supporte pas le format original. Activable dans Dashboard > Playback après installation.
Pour vérifier votre proco : DSM > Panneau de configuration > Info > Système. Si vous voyez « Intel Celeron » récent (J4125, J4205) c'est OK. Si « Realtek RTD » : pas de transcoding HW.
🐳 Créer le container Docker Jellyfin
On va utiliser l'image officielle linuxserver/jellyfin, la plus populaire et bien maintenue.
Méthode 1 : Via Container Manager (interface graphique)
- Ouvrez Container Manager
- Allez dans Registre
- Cherchez "linuxserver/jellyfin"
- Cliquez Télécharger, choisissez le tag "latest"
- Une fois téléchargée, allez dans Image, sélectionnez l'image, cliquez Lancer
- Configurez :
- Nom :
jellyfin - Activer le redémarrage automatique : oui
- Nom :
Configuration avancée à appliquer :
Volumes (dossiers partagés) :
Ports :
Variables d'environnement :
Méthode 2 : Docker Compose (recommandé)
Pour les habitués, voici le fichier docker-compose.yml complet, avec network mode host (recommandé pour DLNA/Chromecast) :
services:
jellyfin:
image: lscr.io/linuxserver/jellyfin:latest
container_name: jellyfin
network_mode: host
environment:
- PUID=1026
- PGID=100
- TZ=Europe/Paris
volumes:
- /volume1/docker/jellyfin:/config
- /volume1/data/films:/data/films
- /volume1/data/series:/data/series
restart: unless-stopped
devices:
- /dev/dri:/dev/dri # Hardware transcoding IntelSauvegardez dans /volume1/docker/jellyfin/docker-compose.yml, puis dans Container Manager > Projet > Créer.
Note sur network_mode: host : en mode host, Jellyfin partage l'IP du NAS directement. C'est nécessaire pour la découverte automatique (Chromecast, DLNA), mais ça veut dire que vous ne pouvez pas avoir 2 services sur le port 8096. Si conflit, remettez bridge + ports manuels.
Image : lscr.io/linuxserver/jellyfin:latest. Network host recommandé pour DLNA/Chromecast/SSDP discovery. Volumes : /config, /data/films, /data/series (paths identiques aux *arr pour le mapping). HW transcoding : /dev/dri exposé pour Intel QSV/VAAPI. Pour NVIDIA : runtime: nvidia + image officielle jellyfin/jellyfin. Backup auto : /config contient toute la DB.
Pourquoi linuxserver et pas l'image officielle Jellyfin ? L'image jellyfin/jellyfin officielle est très bien aussi. La différence : linuxserver gère mieux les permissions Synology (PUID/PGID), suit linuxserver-ci pour les builds réguliers, et a une meilleure compat NAS. Si vous avez NVIDIA GPU et voulez transcoder, l'image officielle peut être préférable.
Hardware transcoding et Synology : sur DS920+/DS923+, l'iGPU Intel est exposé par /dev/dri. Une fois Jellyfin lancé, allez dans Dashboard > Playback > Transcoding > Hardware acceleration et activez "Intel QuickSync (QSV)". Test avec une vidéo 4K HEVC streamée vers téléphone : le CPU doit rester sous 30%.
🚀 Premier lancement et setup wizard
Le container tourne ? On va configurer Jellyfin depuis le navigateur.
- Ouvrez votre navigateur
- Tapez l'URL :
http://[IP-de-votre-NAS]:8096(par exemplehttp://192.168.1.20:8096) - Vous arrivez sur le wizard d'installation
Étape 1 : Choisir la langue
Sélectionnez Français (ou autre selon votre préférence). Cliquez Suivant.
Étape 2 : Créer le compte administrateur
C'est VOTRE compte, le seul qui aura tous les droits. Vous pourrez créer d'autres utilisateurs après.
Wizard : créer le compte admin
Étape 3 : Continuer le wizard
Le wizard continue avec :
- Choix des bibliothèques : on y revient à l'étape 5, vous pouvez skipper pour l'instant
- Langue préférée pour les métadonnées : Français (ou English si vous préférez les jaquettes US)
- Pays préféré : France
- Accès à distance : laissez désactivé pour l'instant (on verra à l'étape 7)
Cliquez Terminer. Vous arrivez sur la page de connexion. Connectez-vous avec votre compte admin.
URL : http://NAS-IP:8096. Wizard : language → admin user → libraries (skip ok) → metadata locale → remote access (off for now). Connexion ensuite. Pas de compte cloud, tout est local. La DB est dans /config/data/jellyfin.db (SQLite).
Pas de compte cloud, c'est libérateur : contrairement à Plex qui exige un compte plex.tv pour la première utilisation, Jellyfin est 100% local. Aucune donnée ne sort de votre NAS, sauf si vous activez explicitement l'accès distant. C'est le rêve des privacy-aware.
Mot de passe oublié ? Si vous perdez le mot de passe admin, vous pouvez le réinitialiser via le fichier /config/data/jellyfin.db. Procédure documentée sur le wiki Jellyfin. Plus simple que sur Plex où il faut passer par leur support.
📚 Ajouter vos bibliothèques
Sans bibliothèques, Jellyfin ne sait pas où sont vos films. On les ajoute maintenant.
- Cliquez sur le menu en haut à gauche (3 traits)
- Allez dans Tableau de bord > Bibliothèques
- Cliquez sur Ajouter une bibliothèque
Bibliothèque #1 : Films
- Type de contenu : Films
- Nom d'affichage : Films (ou "Cinéma", "Movies"...)
- Dossiers : cliquez + et ajoutez
/data/films - Langue préférée pour les métadonnées : Français
- Pays : France
- Section "Téléchargeurs de métadonnées" : cochez TheMovieDB en premier
- Cliquez OK
Bibliothèque #2 : Séries
- Type : Séries TV
- Nom : Séries
- Dossier :
/data/series - Téléchargeurs : TheTVDB et TheMovieDB
- Cliquez OK
Bibliothèques configurées
Premier scan
Une fois les bibliothèques ajoutées, Jellyfin lance un scan complet. Cela peut prendre de 30 minutes à plusieurs heures selon la taille de votre collection.
- Pour 100 films : ~10-20 minutes
- Pour 500 films + 50 séries : ~1-2 heures
- Pour 2000+ médias : la nuit
Vous pouvez suivre la progression dans Tableau de bord > Tâches programmées. Quand c'est fini, retournez sur l'accueil pour voir vos médias avec les jaquettes.
Tableau de bord > Bibliothèques > Ajouter. Type Movies / Shows / Music. Folders mappés sur paths Docker (/data/films, /data/series). Metadata downloaders : TheMovieDB / TheTVDB / OMDb / FanArt.tv. Premier scan : long mais cache parsing futur. Auto-scan watchfolders toutes les heures par défaut.
Métadonnées en français : TheMovieDB a une excellente couverture FR (jaquettes, descriptions, casting). TheTVDB est plus EN-centric, mais marche aussi. Si une série n'est pas reconnue, vous pouvez la corriger manuellement (clic droit > Identifier).
Sous-titres automatiques : Jellyfin peut télécharger des sous-titres via OpenSubtitles (plugin officiel à activer). Mais Bazarr le fait mieux. Si vous avez Bazarr (notre tuto Bazarr), laissez-le gérer les sous-titres et désactivez le plugin Jellyfin pour éviter les doublons.
👨👩👧 Configurer les utilisateurs et le partage famille
Vous voulez que votre conjoint, vos enfants, ou vos parents puissent regarder ? Créez-leur des comptes utilisateurs séparés.
- Tableau de bord > Utilisateurs
- Cliquez + Ajouter un utilisateur
- Nom : "Maman", "Papa", "Léa"...
- Mot de passe (peut être laissé vide si vous voulez un accès simple)
- Cliquez Sauvegarder
Restrictions par utilisateur
Pour chaque utilisateur, vous pouvez configurer :
- Bibliothèques accessibles : par exemple, ne pas donner accès aux films violents pour un enfant
- Limite de classification : automatique selon les ratings TheMovieDB (PG, PG-13, R…)
- Tags interdits : par exemple, exclure "Horreur" pour un enfant
- Heures de visionnage : couvre-feu (par exemple "Pas après 22h les jours d'école")
- Liste de canaux : si vous avez du Live TV ajouté
Exemple : restrictions pour un compte "enfant"
PIN de profil (Jellyfin 10.9+)
Depuis Jellyfin 10.9, vous pouvez ajouter un PIN à 4 chiffres par profil, comme sur Netflix. Pratique pour empêcher les enfants de switcher sur le compte adulte.
Tableau de bord > Utilisateurs > Add. Permissions par user : libraries, max parental rating (TheMovieDB ratings), blocked tags, schedule restrictions. Pas de Plex Home équivalent, mais multi-user natif. PIN profile en 10.9+. Pas de cloud sync : si Jellyfin server down, comptes inaccessibles (pas grave, votre serveur est local).
Pas besoin d'invitation par email : contrairement à Plex (qui demande un email plex.tv pour chaque membre de la famille), Jellyfin crée des comptes locaux. Pas de cloud, pas de tracking, pas de spam.
Limitation : les utilisateurs locaux ne peuvent se connecter que depuis votre réseau local par défaut. Pour l'accès distant, voir l'étape 7. Et pas de "watch together" cross-network sans configuration avancée.
✅ Apps clients et accès distant
Maintenant que tout est en place, comment regarder Jellyfin depuis les différents appareils ?
Apps recommandées par appareil
Apps Jellyfin par plateforme
Configuration des apps
Sur chaque app, à la première ouverture :
- Cliquez Add Server
- Entrez l'IP locale de votre NAS :
http://192.168.1.20:8096 - Connectez-vous avec votre compte Jellyfin (créé à l'étape 4)
Accès distant : 3 méthodes
Pour regarder vos médias depuis l'extérieur (4G, wifi public, vacances), il faut exposer Jellyfin au monde extérieur. Voici les options par ordre de simplicité/sécurité :
Méthode 1 : Tailscale (le plus simple)
http://100.64.0.1:8096) depuis n'importe où, comme si vous étiez à la maison. Gratuit jusqu'à 100 appareils, ultra simple, ultra sécurisé. Méthode 2 : Reverse proxy avec sous-domaine (intermédiaire)
jellyfin.votredomaine.fr vers votre NAS. Avec un certificat SSL Let's Encrypt automatique. Plus complexe à mettre en place, mais accessible depuis n'importe quel navigateur.
Méthode 3 : Port forwarding direct (NON recommandé)
Vérification finale
- Ouvrez Jellyfin Web UI :
http://NAS-IP:8096 - Vérifiez que vos films/séries sont bien listés avec leurs jaquettes
- Lancez une vidéo en lecture pour tester le streaming
- Si vous avez activé le HW transcoding : vérifiez Tableau de bord > Lectures actives. Le statut doit indiquer "Direct play" ou "Transcoding (HW)", pas "Transcoding (CPU)"
- Testez depuis votre téléphone (app Jellyfin)
Jellyfin opérationnel
Votre médiathèque privée tourne sur votre NAS, sans cloud, sans tracking, sans paywall. Bienvenue dans le logiciel libre.
Apps : Jellyfin (Android), Swiftfin (iOS/tvOS), Findroid (Android TV), officielles Roku/LG/Samsung. Add server depuis Web UI à http://NAS-IP:8096. Remote access : Tailscale (recommandé), reverse proxy Nginx/Traefik avec Let's Encrypt, ou port-forward 8096 direct (à éviter sans HTTPS). HW transcoding check : Dashboard > Active Sessions doit afficher hwaccel.
Tailscale, le game changer : c'est ce qu'on recommande à 99% des utilisateurs Jellyfin. Vous installez le client sur votre NAS Synology (paquet community ou Docker) et sur vos téléphones/PC. Vous obtenez une adresse IP privée stable (ex: 100.64.x.x) accessible depuis n'importe où. C'est comme un VPN personnel, mais ultra-simple. Voir le site officiel.
Pour les Smart TV anciennes (avant 2020) : elles n'ont souvent pas d'app Jellyfin. La solution : un Chromecast ou FireStick branché en HDMI. Pour ~30€, vous avez accès à toutes les apps Jellyfin/Plex/etc. quel que soit l'âge de la TV.