,

Jellyfin 12.0 : ce qui casse avant de mettre à jour votre serveur

Abstract violet and amber illustration representing a home media server and streaming network

Read this article in English: Jellyfin 12.0 Is Out: What Breaks Before You Upgrade.

Jellyfin 12.0 est sorti le 7 septembre 2026, après plusieurs mois coincé en version candidate. C’est la sortie la plus importante depuis la scission avec Emby en 2018, et le numéro de version le trahit dès le premier coup d’œil : ce build s’annonce comme 12.0, pas 10.12.0.

Ce n’est pas une coquille. Jellyfin abandonne le préfixe « 10 » qui traînait dans ses numéros de version depuis le fork. Ce qui se serait appelé 10.12.0 devient simplement 12.0, et la branche 10.11.x est la dernière à suivre l’ancien schéma. La raison donnée par l’équipe vaut la peine d’être connue : la 10.11.0 avait entièrement réécrit la base de données de la bibliothèque, ce qui en faisait une version majeure dans les faits, mais son numéro d’allure mineure a masqué cet impact et pris pas mal d’utilisateurs au dépourvu. La nouvelle numérotation est censée éviter que ça se reproduise.

Avant de mettre à jour

Le schéma de base de données change encore avec la 12.0, et vos données sont réécrites dès le premier démarrage du nouveau serveur. Il n’y a pas de retour en arrière possible sans restauration complète : sauvegardez votre configuration et votre base Jellyfin avant de toucher à quoi que ce soit.

Plusieurs autres points comptent tout autant :

  • Chemin de mise à jour supporté : il faut être en 10.10.7 ou sur n’importe quelle version 10.11.x avant de passer à la 12.0. Un saut direct depuis une 10.11.x est pleinement pris en charge.
  • Les noms d’utilisateur deviennent insensibles à la casse. Si deux comptes existants ne diffèrent que par la capitalisation, la migration de la base de données échouera purement et simplement.
  • Un scan complet de la bibliothèque est obligatoire après la mise à jour. Les versions alternatives que Jellyfin regroupait automatiquement (pas celles fusionnées à la main) sont effacées pendant la mise à jour et apparaîtront comme « manquantes » tant que ce scan n’est pas terminé.
  • Ce premier scan post-mise à jour tourne nettement plus longtemps que d’habitude, et certains films peuvent brièvement sembler « nouvellement ajoutés ». C’est normal, pas un bug.
  • Retirez les plugins tiers avant la mise à jour. Tout ce qui a été compilé pour la 10.11 ne se chargera pas sur la 12.0 et devra être recompilé par son auteur. Les plugins officiels sont déjà à jour.
  • Les très anciens clients tiers cesseront de se connecter. La prise en charge des anciens chemins d’API /emby/ et /mediabrowser/ a été supprimée, et l’ancienne méthode de connexion est désormais désactivée, même sur les serveurs qui tournaient jusque-là sans problème avec elle.

Bref, ce n’est pas une mise à jour à lancer les yeux fermés. Passez en revue votre liste de plugins, vérifiez vos noms de comptes, et assurez-vous que votre sauvegarde se restaure vraiment avant de commencer.

La sécurité justifie déjà la mise à jour à elle seule

Même sans les nouveautés, la 12.0 vaut le coup rien que pour ses correctifs de sécurité. Cette version corrige plusieurs failles qui permettaient à une requête forgée d’accéder à des fichiers en dehors des répertoires que Jellyfin est censé servir. Elle referme aussi une faille permettant de relancer l’assistant de configuration d’un serveur mal paramétré sans authentification, rejette les paquets de plugins aux noms de fichiers dangereux, applique le contrôle parental de façon plus cohérente, et corrige des failles XSS dans le client web.

Pour ceux qui pilotent des migrations planifiées, Jellyfin ajoute aussi un indicateur de ligne de commande --mode MigrateSystem, qui lance la migration de la base de données toute seule, sans démarrer le reste du serveur.

Les nouveautés au-delà du numéro de version

Les changements les plus marquants touchent la stabilité en charge et des types de contenu que Jellyfin ne gérait pas vraiment jusqu’ici :

  • Les playlists et collections sont passées d’un gros bloc unique en base de données à une ligne par élément. Compter, paginer et éditer de grandes playlists est nettement plus rapide, et la suppression en masse ne s’arrête plus en cours de route.
  • Les versions alternatives, jusqu’ici réservées aux films, fonctionnent désormais aussi pour les épisodes de séries.
  • Les livres et bandes dessinées sont pris en charge nativement côté serveur pour la première fois : Jellyfin lit directement les métadonnées OPF et ComicInfo, génère des affiches pour les formats EPUB et bande dessinée, et embarque une interface de lecture repensée. Le plugin Bookshelf est déprécié, ses fonctionnalités étant désormais intégrées au cœur du serveur.
  • La source des recommandations « plus comme ceci » devient configurable par bibliothèque, et ListenBrainz est désormais livré avec le serveur comme option native pour les recommandations musicales.
  • Le layout « Modern », jusqu’ici optionnel et expérimental, devient l’interface par défaut sur ordinateur comme sur mobile. L’ancienne interface est renommée « Legacy » et reste disponible pour qui la préfère.
  • Le serveur est désormais compilé avec FFmpeg 8.1.

Faut-il mettre à jour dès aujourd’hui ?

Si vous tournez avec des plugins, comptez une heure pour vérifier qu’ils ont été mis à jour pour la 12.0 avant de vous lancer. Si votre installation ne dépend d’aucun plugin et que vos sauvegardes sont solides, cette version mérite d’être installée rapidement, ne serait-ce que pour les correctifs de sécurité. Ne sautez pas la check-list de pré-mise à jour ci-dessus, et ne vous inquiétez pas si le premier scan de bibliothèque prend du temps.

Pour comprendre le projet derrière cette sortie, notre histoire de Jellyfin retrace comment le projet s’est séparé d’Emby en 2018 pour devenir le média-serveur que la communauté du self-hosting choisit par défaut. Notre fiche Jellyfin a des notes d’installation utiles si vous découvrez l’outil.

Le détail complet se trouve dans l’annonce officielle de la version 12.0 publiée par l’équipe cœur de Jellyfin, et le changelog technique complet est sur GitHub.

Related guides