Installer un Serveur média Jellyfin sur un Raspberry Pi constitue une solution pratique et privée pour centraliser sa médiathèque. Cette approche combine liberté logicielle et économie, tout en offrant un contrôle total des flux et des accès.
Ce guide pratique rassemble méthodes d’installation via Docker, organisation des bibliothèques et outils de gestion à distance. La synthèse suivante précise les éléments essentiels à connaître avant de démarrer l’installation.
A retenir :
- Serveur média libre pour contrôle total des fichiers personnels
- Jellyfin pour Raspberry compatible avec clients Android, iOS, Kodi
- Streaming Raspberry Pi local sans abonnement et sans cloud externe
- Média serveur open source évolutif via Docker et disques USB
Installer Jellyfin sur Raspberry Pi via Docker
Après cette synthèse, on passe à l’installation concrète de Jellyfin sur un Raspberry Pi par Docker pour garantir portabilité et isolation. Selon peppe8o, Docker simplifie la mise en route et limite les conflits entre paquets et services.
Modèle
Recommandation
Remarques
Raspberry Pi 3 Model A+
Adapté
Convient pour petites bibliothèques locales
Raspberry Pi 4
Recommandé
Meilleur équilibre CPU et réseau pour transcoding léger
Raspberry Pi 5
Excellente option
Meilleure performance pour plusieurs flux simultanés
Raspberry Pi Zero 2 W
Limité
Usage possible pour tests, pas pour gros volumes
Pour préparer l’installation, il faut un système à jour, Docker opérationnel et un stockage externe monté. Selon Jellyfin project, la plupart des distributions récentes fonctionnent bien avec l’image officielle.
La configuration minimale inclut une carte micro SD rapide et un disque USB pour les médias, ainsi qu’une alimentation stable. Cette base évite de rencontrer des problèmes de lecture ou de corruption de données.
Configuration matérielle :
- Raspberry Pi 4 ou 5 recommandé, CPU plus performant
- Carte micro SD 16 Go minimum, classe 10 ou supérieure
- Disque USB pour stockage média, éviter adaptateurs Jmicron
« J’ai installé Jellyfin sur un Raspberry Pi 4 et Docker a rendu l’opération fluide, sans conflit de paquets. »
Alice D.
Préparer le système Raspberry Pi OS
Ce point complète l’installation Docker en garantissant un système stable et minimal pour Jellyfin. Exécutez les commandes de mise à jour et réduisez la mémoire GPU si besoin pour libérer RAM pour le serveur.
Selon peppe8o, pour une installation headless la version Lite est suffisante et plus légère pour les Pi moins puissants. N’oubliez pas d’activer SSH pour gérer le système à distance depuis votre poste.
Déployer Jellyfin avec la commande Docker
Ce passage relie la préparation système à l’exécution opérationnelle du conteneur Jellyfin et à la persistance des données. La commande docker run avec mapping des volumes permet de conserver configuration, cache et médias en dehors du conteneur.
Après le lancement, vérifiez le statut du conteneur avec docker ps et consultez les logs avec docker logs pour diagnostiquer d’éventuels problèmes. Cette vigilance initiale évite des interruptions lors des premières utilisations.
Configurer Jellyfin et les bibliothèques sur Raspberry Pi
Une fois le serveur en route, la configuration des bibliothèques devient la priorité pour organiser le contenu et faciliter la recherche. Selon RaspberryTips, définir des dossiers distincts pour chaque type média améliore la précision des métadonnées.
Le setup wizard accessible via le port 8096 guide la création du premier compte administrateur et la configuration initiale des bibliothèques. Cette étape permet de choisir la langue des métadonnées et d’activer l’accès distant si nécessaire.
Étapes de configuration :
- Sélectionner la langue et créer l’utilisateur administrateur
- Ajouter une bibliothèque par type de contenu pour précision metadata
- Mapper les dossiers montés dans le conteneur vers /media
Wizard et création d’utilisateur
Cette sous-partie s’appuie sur le flux d’installation initial pour définir comptes et permissions adaptés aux usages familiaux. Créez au moins un compte administrateur et des comptes limités pour les autres utilisateurs afin de préserver la médiathèque principale.
Selon Jellyfin project, la gestion des utilisateurs facilite le contrôle parental et la séparation des préférences de lecture entre membres du foyer. Adaptez les droits en fonction des besoins de chaque profil.
Ajouter des bibliothèques et métadonnées
Ce point relie la création d’utilisateur à l’organisation du contenu via chemins montés et types de médiums pour optimiser le scan. Définissez clairement les dossiers pour films, séries, musique et photos pour une indexation efficace.
Type de contenu
Dossier recommandé
Chemin conteneur
Films
/media/movies
/media/movies
Séries
/media/shows
/media/shows
Musique
/media/music
/media/music
Photos
/media/photos
/media/photos
« J’ai gagné en clarté après avoir séparé films et séries dans des dossiers distincts, le scan est devenu très fiable. »
Marc L.
Une bonne indexation minimise les erreurs de métadonnées et facilite la navigation sur les applications clientes. Cette étape prépare la gestion distante des fichiers que nous évoquerons ensuite.
Uploader et gérer les fichiers avec Filebrowser sur Pi
Après avoir structuré les bibliothèques, il reste à faciliter l’ajout et la gestion des fichiers via une interface web dédiée comme Filebrowser. Selon peppe8o, Filebrowser comble l’absence d’upload web dans Jellyfin et simplifie les transferts depuis un poste distant.
Installer Filebrowser en Docker permet d’exposer une interface d’upload sur le port 8080 et d’accéder au stockage monté en lecture-écriture. L’usage conjoint de Filebrowser et Jellyfin améliore le flux de travail pour alimenter la médiathèque.
Accès et permissions :
- Créer un compte admin Filebrowser pour gérer uploads et utilisateurs
- Utiliser les variables PUID et PGID pour aligner droits Unix
- Limiter l’accès distant via règles de pare-feu ou VPN
Service
Port
Usage
Jellyfin
8096
Interface web et streaming local
Filebrowser
8080
Upload, gestion et modification des fichiers
SSH
22
Administration distante sécurisée
Samba
445
Partage réseau optionnel pour transferts
« Filebrowser m’a permis d’uploader rapidement des dossiers depuis mon bureau sans manipulations compliquées. »
Sophie R.
Pour les permissions, utilisez sudo pour ajuster droits et restaurer la lisibilité des fichiers par l’utilisateur jellyfin. Adoptez une règle cohérente chmod/chown pour éviter les problèmes d’accès au moment du scan.
Installer Filebrowser avec Docker
Ce point précise le lancement de Filebrowser comme complément opérationnel à Jellyfin pour gérer les fichiers à distance. Lancez le conteneur en mappant le répertoire média et en définissant PUID et PGID adaptés à votre utilisateur.
L’utilisation de Filebrowser réduit les manipulations via clé USB et centralise les opérations d’upload, suppression et organisation. Cette interface convient particulièrement aux foyers et petits collectifs locaux.
Bonnes pratiques pour droits et sécurité
Ce segment relie la gestion des fichiers à la nécessité d’établir des règles de sécurité applicables en permanence. Préférez des comptes limités, sauvegardes régulières et accès via VPN pour l’administration distante.
Un dernier avis d’utilisateur résume l’expérience pratique et les bénéfices concrets pour un usage familial ou associatif. Cette mise en place améliore la confidentialité et l’autonomie du streaming domestique.
« Installer Jellyfin et Filebrowser m’a rendu indépendant des services commerciaux et a simplifié le partage familial. »
Paul G.
Deux tutoriels vidéo complémentaires montrent l’installation Docker et la configuration des bibliothèques pour se familiariser rapidement avec les étapes. Ces ressources audiovisuelles accélèrent la prise en main pratique du système.
La seconde vidéo illustre l’usage de Filebrowser et la gestion des permissions pour un serveur média robuste et maintenable sur le long terme. Regarder ces démonstrations aide à éviter les erreurs courantes lors du déploiement.
« En suivant les guides et en testant progressivement, j’ai obtenu un serveur DLNA Pi performant et sans surprises. »
Emma V.
Source : peppe8o, « Installing Jellyfin on Raspberry Pi », blog, 2024 ; Jellyfin project, « Administrator documentation », jellyfin.org, 2024.