Anime-Sanctuary

Jellyfin

Vos films de famille dorment dans des dossiers, sur un disque ou dans un ordinateur. Installons Jellyfin, un serveur multimédia personnel, pour les regarder depuis un navigateur, un téléphone ou une télé.

Parcours
Tutoriel 23 sur 35
Durée
40 min de lecture
Vérifié avec
Commandes : essais sous Debian 13 (Jellyfin 12.4)
Ce que vous saurez faire
  • Écrire un fichier Compose pour Jellyfin avec ses trois dossiers.
  • Créer le compte administrateur et ajouter une bibliothèque de vidéos.
  • Savoir comment le rendre accessible sans exposer son port tel quel.
  • Sauvegarder sa configuration et mettre Jellyfin à jour.

Avant de commencer : Docker et Docker Compose.

Sommaire
  1. Ce que fait un serveur multimédia
  2. Préparer les dossiers
  3. Écrire le fichier Compose
  4. Premier démarrage
  5. Créer le compte administrateur
  6. Ajouter une bibliothèque
  7. Regarder sur navigateur, téléphone et télé
  8. L'ouvrir sans exposer son port
  9. Sauvegarder et mettre à jour
  10. Si ça échoue
  11. La suite
  12. Sources

Comment installer Jellyfin avec Docker Compose sur Debian ? Il faut un fichier Compose d'une dizaine de lignes, trois dossiers bien rangés et un compte à créer : comptez quarante minutes. Vous obtenez un serveur multimédia personnel, qui présente vos propres vidéos comme une petite plateforme de streaming.

Ce que fait un serveur multimédia

Un serveur multimédia personnel est un bibliothécaire qui vit sur votre serveur : il connaît vos vidéos, leur donne une affiche et un titre, et les prête à tous vos écrans. Jellyfin en est un, libre et gratuit. Vous lui dites où sont vos fichiers, il en fait une vitrine. Il va chercher sur Internet les affiches et les résumés des films, mais vos fichiers vidéo restent chez vous.

Tous vos appareils ne lisent pas tous les formats. Quand une télé ne sait pas lire un fichier tel quel, Jellyfin le convertit à la volée : c'est le transcodage. Il fait travailler le processeur, le cerveau de la machine, donc un petit serveur le ressent. Pour mettre cela en place, il faut d'abord des dossiers bien rangés.

1Préparer les dossiers

Jellyfin a besoin de trois dossiers : un pour sa configuration (comptes, réglages, historique de lecture), un pour son cache (des fichiers jetables comme les vignettes) et un pour vos vidéos. Nous les créons nous-mêmes, avant Docker. Sinon Docker les crée au nom de root, le compte administrateur, et Jellyfin n'aurait pas le droit d'y écrire.

Sur le serveur
mkdir -p ~/jellyfin/config ~/jellyfin/cache ~/jellyfin/media/Films
cd ~/jellyfin

Dans media/Films, un dossier par film, nommé comme le film, avec l'année entre parenthèses. Jellyfin lit ce nom pour retrouver le titre et l'année. Pour un film de vacances, le dossier s'appelle Vacances a la mer (2019) et le fichier à l'intérieur porte le même nom, suivi de .mp4.

Pour déposer vos vidéos depuis votre ordinateur, utilisez rsync, vu dans Première sauvegarde avec rsync. Le dossier Videos de la commande est le vôtre, celui qui contient vos films.

Sur votre ordinateur
rsync -av Videos/ alice@203.0.113.10:jellyfin/media/Films/

Les dossiers existent et les vidéos arrivent. Reste à écrire le fichier qui décrit le conteneur.

2Écrire le fichier Compose

Un seul service suffit : Jellyfin porte sa propre base de données. Le fichier reprend ce que vous savez de l'article Docker et Docker Compose. Il lie chaque dossier du serveur à un dossier dans le conteneur, et il réserve le port au serveur lui-même.

Une ligne mérite une vérification avant de copier : user. Elle indique le compte Linux sous lequel Jellyfin tourne. Ce sera le vôtre plutôt que root, ce qui limite les dégâts en cas de faille. Ce compte s'écrit avec deux nombres : id -u donne votre numéro d'utilisateur, id -g celui de votre groupe. Si alice est le premier compte créé, c'est 1000 deux fois.

Sur le serveur
id -u
id -g

Si vous voyez autre chose que 1000, remplacez "1000:1000" par vos deux nombres, séparés par deux-points. Dans la commande suivante, cat recopie dans docker-compose.yml le texte placé entre <<'EOF' et la ligne EOF.

Sur le serveur
cat > docker-compose.yml <<'EOF'
services:
  jellyfin:
    image: jellyfin/jellyfin:12.4
    restart: unless-stopped
    user: "1000:1000"
    ports:
      - "127.0.0.1:8096:8096"
    volumes:
      - ./config:/config
      - ./cache:/cache
      - ./media:/media:ro
EOF

Chaque ligne a sa raison :

  • jellyfin/jellyfin:12.4 : l'image officielle, à version fixe. Rien ne change sans que vous l'ayez décidé.
  • 127.0.0.1:8096:8096 : le port 8096 est ouvert au serveur seulement. Personne d'autre ne peut l'atteindre pour l'instant, c'est voulu.
  • ./config et ./cache : ces deux dossiers du serveur sont reliés à /config et /cache dans le conteneur. Jellyfin y écrit.
  • user: "1000:1000" : le compte sous lequel Jellyfin lit et écrit ses dossiers, celui que vous venez de vérifier.
  • ./media:/media:ro : vos vidéos, en lecture seule (ro). Jellyfin peut les lire, jamais les effacer ni les modifier.

Le fichier est prêt. Allumons Jellyfin.

3Premier démarrage

La première commande télécharge l'image, assez volumineuse, puis démarre le conteneur. L'option -d de up -d le laisse tourner en arrière-plan, sans bloquer le terminal. Jellyfin a besoin d'une trentaine de secondes pour être prêt.

Sur le serveur
sudo docker compose up -d

Attendez une demi-minute, puis posez-lui la question simple : es-tu en forme ? Jellyfin répond sur une adresse prévue pour cela.

Sur le serveur
curl -s http://127.0.0.1:8096/health
Résultat attendu
Healthy

« Healthy » signifie « en bonne santé ». Si vous obtenez une erreur de connexion, patientez dix secondes et recommencez. Jellyfin tourne, mais il n'a encore aucun compte : voyons comment l'atteindre depuis chez vous.

4Créer le compte administrateur

Au premier lancement, Jellyfin ouvre un assistant de configuration qui crée le compte administrateur. Cet assistant n'a pas de mot de passe : le premier qui arrive devient maître des lieux. Voilà pourquoi le port est réservé au serveur, et pourquoi vous passez par un tunnel.

Un tunnel SSH relie le port 8096 de votre ordinateur à celui du serveur, à travers la connexion SSH. Vous l'avez vu avec Nextcloud ; la commande est la même, sur un autre port. Gardez cette fenêtre ouverte pendant toute la configuration.

Sur votre ordinateur
ssh -L 8096:127.0.0.1:8096 alice@203.0.113.10

Ouvrez ensuite http://localhost:8096 dans votre navigateur. L'assistant vous guide en quelques écrans :

  1. Choisissez la langue de l'interface.
  2. Saisissez un nom d'utilisateur, par exemple alice, et un mot de passe long, tiré de votre gestionnaire de mots de passe.
  3. Passez l'écran des bibliothèques : nous les ajouterons à l'étape suivante.
  4. Choisissez votre langue pour les titres et les résumés des films.
  5. Laissez l'accès à distance autorisé, puis terminez.

Vous arrivez sur la page de connexion, puis sur un accueil encore vide. Votre serveur a un administrateur, et c'est vous. Il lui manque des vidéos à présenter.

5Ajouter une bibliothèque

Une bibliothèque est un dossier que vous confiez à Jellyfin, avec un type : films, musique, séries. Jellyfin le parcourt et affiche ce qu'il y trouve. Dans le tableau de bord (le menu en haut à gauche), ouvrez « Bibliothèques », puis ajoutez-en une :

  • Type de contenu : « Films » pour des vidéos, « Musique » pour des morceaux. Choisissez celui qui correspond à votre dossier.
  • Nom : ce que vous voulez, par exemple « Films de famille ».
  • Dossier : /media/Films. C'est le chemin à l'intérieur du conteneur, celui de la colonne de droite dans le fichier Compose, pas ~/jellyfin/media/Films.

Validez : Jellyfin parcourt le dossier. Pour un film court, comptez quelques secondes. Vous pouvez vérifier côté serveur que le conteneur voit bien vos fichiers.

Sur le serveur
sudo docker compose exec jellyfin ls /media/Films
Résultat attendu
Vacances a la mer (2019)

Dans l'interface, le film apparaît sur l'accueil, avec son titre et son année. Jellyfin sait donc lire vos fichiers. Regardons-en un.

6Regarder sur navigateur, téléphone et télé

Dans le navigateur, cliquez sur le film, puis sur le bouton de lecture : il démarre tout de suite, par le tunnel. C'est le test le plus simple, et il suffit pour vérifier que tout marche.

Pour l'instant, Jellyfin n'est joignable que depuis votre ordinateur, par le tunnel. Si c'est tout ce qu'il vous faut, passez à la sauvegarde, à l'étape 8. La suite ouvre Jellyfin à vos autres appareils : elle demande un nom de domaine et du HTTPS, et elle rend le serveur visible sur Internet.

Téléphone et télé : les applications

Il faut une adresse qui marche en dehors du tunnel, donc un nom de domaine, vu dans Nom de domaine et DNS, et du HTTPS. Jellyfin propose des applications gratuites pour les téléphones Android et iPhone, pour les télés Android TV et Fire TV, et d'autres. Vous y saisissez l'adresse de votre serveur, puis votre nom et votre mot de passe. La liste complète est sur la page des clients de Jellyfin, citée dans les sources.

7L'ouvrir sans exposer son port

Ouvrir le port 8096 tel quel enverrait vos mots de passe et vos vidéos en clair sur Internet. Pour joindre Jellyfin depuis vos autres appareils, il faut donc une porte d'entrée solide. C'est le rôle d'un Reverse proxy : il reçoit les visiteurs en HTTPS, avec le certificat de HTTPS avec Let's Encrypt, puis transmet leur demande à 127.0.0.1:8096.

La configuration est celle de l'article dédié, avec trois changements. L'adresse visée est 127.0.0.1:8096. Votre domaine est par exemple jellyfin.exemple.fr. Enfin, la ligne ProxyPass se termine par upgrade=websocket, soit ProxyPass / http://127.0.0.1:8096/ upgrade=websocket. Cette option laisse passer les connexions ouvertes en continu que Jellyfin utilise pour sa télécommande.

Dans les applications, l'adresse à saisir devient alors https://jellyfin.exemple.fr. Tout Internet peut maintenant atteindre la page de connexion : gardez un mot de passe long et ne créez de comptes que pour des personnes de confiance. Il reste à protéger ce que vous venez de construire.

8Sauvegarder et mettre à jour

Ce qui compte, c'est le dossier config : vos comptes, vos bibliothèques, l'état de lecture de chacun. Le cache se reconstruit tout seul, et vos vidéos se sauvegardent à part, comme dans Première sauvegarde avec rsync. Pour une copie cohérente, on arrête Jellyfin quelques secondes, on archive config avec tar, qui range le dossier dans un seul fichier compressé, puis on relance.

Sur le serveur
cd ~/jellyfin
sudo docker compose stop
tar czf jellyfin-config.tar.gz config
chmod 600 jellyfin-config.tar.gz
sudo docker compose start

L'archive contient vos comptes : chmod 600 la réserve à vous seul. Elle pèse quelques centaines de Ko pour une petite bibliothèque, davantage avec beaucoup de films. Une sauvegarde qui reste sur le serveur ne protège pas d'une panne du serveur : copiez-la ailleurs.

Restaurer la configuration

On arrête Jellyfin, on met la configuration actuelle de côté, on extrait l'archive dans ~/jellyfin, qui recrée config, puis on relance.

Sur le serveur
cd ~/jellyfin
sudo docker compose stop
mv config config.ancien
tar xzf jellyfin-config.tar.gz
sudo docker compose up -d

Une mise à jour remplace le conteneur par un plus récent, qui garde vos dossiers. Faites la sauvegarde d'abord, puis téléchargez et recréez.

Sur le serveur
sudo docker compose pull
sudo docker compose up -d

Le numéro 12.4 reçoit les corrections de cette série. Pour passer à la suivante, changez le numéro dans le fichier, puis relancez les deux commandes.

Si ça échoue

Quatre situations reviennent :

  • Jellyfin refuse d'ajouter le dossier. Vous avez saisi un chemin du serveur au lieu d'un chemin du conteneur. Le journal le dit : sudo docker compose logs jellyfin | grep "does not exist" affiche par exemple The specified path does not exist: /home/alice/videos. Saisissez /media/Films.
  • La bibliothèque est ajoutée, mais aucun film n'apparaît. Le conteneur n'a pas le droit de lire vos fichiers. Testez avec sudo docker compose exec jellyfin ls /media/Films : une réponse Permission denied confirme le problème. Donnez les dossiers au compte de Jellyfin, celui de la ligne user : sudo chown -R 1000:1000 ~/jellyfin/media, avec vos deux nombres si ce ne sont pas 1000. Ne rendez pas les films lisibles par tous les comptes du serveur.
  • Le film apparaît sous un nom de fichier brut, sans affiche. Le nom du dossier ne suit pas la forme « Titre (année) ». Renommez-le, puis relancez l'analyse de la bibliothèque depuis le tableau de bord.
  • port is already allocated. Le port 8096 est pris par autre chose. Changez le premier 8096 dans le fichier, comme dans l'article sur Docker.

La suite

Vos vidéos ont maintenant leur vitrine, avec un compte, une sauvegarde et un accès propre. Vos BD numérisées et vos livres numériques méritent la leur. L'article suivant, Kavita, applique la même méthode à un lecteur fait pour eux.