Comment configurer le cache et le stockage temporaire de Jellyfin

Eva Wong

IceWhale author

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les homelabs et les logiciels open source, elle se spécialise dans la traduction de concepts techniques complexes en guides accessibles et pratiques. Eva croit que l’auto-hébergement doit être amusant, pas intimidant. À travers ses tutoriels, elle donne à la communauté les moyens de démystifier les configurations matérielles, depuis la construction de leur premier NAS jusqu’à la maîtrise des conteneurs Docker.

How to Configure Jellyfin Cache and Temporary Storage - Zima Store Online

Configurez le stockage de Jellyfin en séparant l’état durable du cache reconstructible et des fichiers temporaires de transcodage générés par à-coups : la base de données et la configuration doivent se trouver sur le chemin local le plus fiable.

Sur un serveur domestique, un SSD rapide peut héberger la configuration, la base de données, le cache et l’espace de travail temporaire du transcodage, tandis que les médias volumineux restent sur un stockage de plus grande capacité. Mappez explicitement chaque répertoire, vérifiez l’utilisateur du conteneur et le seuil d’espace libre, puis redémarrez et exécutez un transcodage représentatif avant de considérer la configuration comme terminée.

Mappez les chemins durables, reconstructibles et temporaires

Les chemins de Jellyfin utilisent les valeurs par défaut ou des points de montage non documentés. Commencez par la vérification la moins intrusive : affichez les chemins effectifs des données, de la configuration, du cache, des journaux, de l’interface web et du transcodage, puis classez chacun comme durable, reconstructible ou temporaire.

L’observation utile est précise : les chemins durables sont sur un SSD local, les fichiers temporaires sur la partition racine presque pleine et le cache sur un partage réseau. Consignez le résultat avant de modifier une autre variable. chemins effectifs de Jellyfin

Interprétez le résultat au lieu de deviner. Si les chemins durables sont locaux et fiables, conservez-les ; si l’espace temporaire est limité, déplacez uniquement les fichiers temporaires ; si la base de données ou la configuration est distante, relocalisez-les avant d’ajuster la lecture.

Configurez les chemins et les autorisations du conteneur

Les rôles de stockage sont sélectionnés. Commencez par la vérification la moins intrusive : appliquez une modification de chemin à la fois, inspectez la table des montages et créez un fichier de test ou un fichier temporaire avec l’utilisateur de Jellyfin.

L’observation utile est précise : le test d’écriture réussit, l’accès est refusé ou le chemin pointe vers un répertoire vide. Consignez le résultat avant de modifier une autre variable. système de fichiers local monté

Interprétez le résultat au lieu de deviner. Si les écritures réussissent, continuez ; si les autorisations échouent, corrigez le propriétaire sans supprimer les données ; si le chemin est vide, corrigez la cible du montage avant de relancer l’analyse.

Définissez un seuil d’espace libre pour le cache et les transcodages

Les chemins sont configurés et accessibles en écriture. Commencez par la vérification la moins intrusive : exécutez le scénario de lecture normal le plus exigeant, mesurez la croissance des fichiers temporaires et la latence d’écriture, puis définissez une alerte avant le point de défaillance.

L’observation utile est précise : l’espace temporaire reste stable, le volume se remplit pendant les pics ou le cache augmente sans être purgé. Consignez le résultat avant de modifier une autre variable. seuil d’espace libre pour le transcodage

Interprétez le résultat au lieu de deviner. S’il reste stable, conservez le seuil et surveillez-le ; s’il se remplit, déplacez ou agrandissez l’espace temporaire avant d’ajouter des flux ; si le cache n’est jamais purgé, inspectez son chemin et la tâche de maintenance.

-15% OFF

ZimaBoard 2 - Mini serveur domestique pour votre grande idée

Single board computer zimaboard2

Redémarrez et rejouez un transcodage représentatif

Les chemins de stockage et le seuil d’espace libre sont configurés. Commencez par la vérification la moins intrusive : redémarrez Jellyfin une fois, confirmez les chemins effectifs, lancez une lecture directe et un transcodage avec sous-titres ou mise à l’échelle, puis vérifiez le nettoyage des fichiers temporaires.

L’observation utile est précise : les chemins persistent et la lecture réussit, le transcodage bascule sur le processeur ou les écritures temporaires échouent. Consignez le résultat avant de modifier une autre variable.

Interprétez le résultat au lieu de deviner. Si les chemins et la lecture fonctionnent, arrêtez-vous là ; si un basculement vers l’accélération logicielle apparaît, diagnostiquez séparément le mappage ; si les écritures temporaires échouent, restaurez le dernier chemin fonctionnel et corrigez le propriétaire.