Vous avez installé Jellyfin, tout fonctionnait hier, et aujourd'hui l'interface web tourne dans le vide ou refuse de s'afficher. Avant de craindre le pire, la plupart des cas où « jellyfin ne fonctionne pas » se ramènent à quelques points que vous pouvez vérifier vous-même en quelques minutes. Ce guide parcourt d'abord cette liste de vérifications, puis explique ce que couvre concrètement une session d'assistance en prise en main, comment fonctionne la facturation par tranches de 15 min et comment l'accès distant reste sécurisé.
Il s'adresse aux personnes qui administrent leur propre serveur : vous êtes à l'aise dans un terminal, vous cherchez simplement un second regard quand quelque chose refuse de coopérer.
Prérequis
- Un serveur exécutant Jellyfin, Emby Server, Nextcloud ou mailcow que vous contrôlez (accès SSH ou console).
- L'accès aux journaux de votre service et à la configuration de votre proxy inverse.
- Un compte Telegram, au cas où vous décidez de réserver une session.
- Un compte sur notre site, pour que vos heures de support et vos sessions apparaissent sous Support.
Étape 1 : cinq vérifications avant de demander de l'aide
Ce sont les mêmes bases qu'un ingénieur support vous demandera en premier ; les faire en amont fait gagner du temps à tout le monde.
1. Lire les journaux
Ouvrez le journal de Jellyfin et regardez les dernières lignes avant l'échec. Les erreurs liées à des fichiers manquants, des permissions, des verrous de base de données ou des échecs de liaison pointent généralement droit vers la cause. Faites de même pour votre proxy inverse et pour Docker, si vous exécutez le serveur dans un conteneur.
2. Vérifier les ports
Confirmez que le service écoute réellement et qu'il est joignable. Si l'interface web ne s'affiche pas, testez d'abord en local (par exemple avec curl sur l'adresse et le port locaux), puis depuis l'extérieur. Un port qui répond en local mais pas à distance indique un problème de pare-feu, de NAT ou de configuration du proxy plutôt que de Jellyfin lui-même.
3. Regarder les certificats
Si la page s'affiche en HTTP simple mais pas en HTTPS, ou si votre navigateur signale un problème de certificat, le souci vient de la configuration TLS ou du proxy, pas du serveur multimédia. Vérifiez les dates d'expiration et si le proxy présente le bon certificat pour le nom d'hôte.
4. Vérifier l'espace disque
Un disque plein casse les bases de données, les journaux et les transcodages de manière déroutante. Vérifiez l'espace libre sur le volume qui contient votre configuration et votre cache, pas seulement sur le volume multimédia.
5. Noter vos versions
Notez les versions du serveur, du plugin ou de l'application, de Docker (le cas échéant), du proxy inverse et du système d'exploitation. Un nombre surprenant de problèmes vient d'incompatibilités de versions, et avoir les numéros sous la main accélère beaucoup le diagnostic.
Étape 2 : ce qu'il faut envoyer
Quand vous nous contactez, indiquez :
- les versions de l'étape 1 ;
- les extraits de journaux pertinents autour de l'échec (pas le fichier entier) ;
- des captures d'écran de l'erreur dans le navigateur ou l'application ;
- une brève description de ce qui a changé depuis le dernier fonctionnement (une mise à jour, un nouveau plugin, une licence déplacée, une modification du proxy).
Les questions qui tiennent dans un e-mail ou un ticket restent gratuites. Le support standard par e-mail et tickets de support est inclus avec les abonnements actifs et pendant un mois après un achat à vie ; commencez donc par là si votre question est simple.
Étape 3 : réserver une session quand vous voulez une aide en prise en main
Si vous préférez que quelqu'un examine le serveur avec vous, achetez des heures de support sur la page Support technique. Les heures apparaissent dans votre compte sous Support.
Depuis votre compte, réservez une session en choisissant un créneau libre au moins 12 heures à l'avance. Vous pouvez déplacer la session jusqu'à 2 fois, ou l'annuler jusqu'à 24 heures avant son début.
Étape 4 : comment se déroule la session
La session se tient sur Telegram. Si besoin, nous utilisons la prise en main à distance de votre serveur. Vous gardez le contrôle pendant toute la durée et pouvez interrompre l'accès distant à tout moment. Cette combinaison, d'abord la discussion puis la prise en main à distance seulement quand elle aide, garde la session ciblée et vous laisse aux commandes.
Étape 5 : comprendre la facturation
La facturation se fait par tranches de 15 min : seul le temps réellement utilisé est déduit de votre solde. Ce qui reste est conservé dans votre compte pendant 12 mois et peut aussi servir plus tard pour des travaux de développement. Vous pouvez consulter vos heures restantes dans votre compte sous Support. Les factures sont émises par Stripe et disponibles dans votre compte.
Étape 6 : savoir ce que couvre le support
Une session couvre notamment :
- l'installation et la configuration de nos plugins Emby et Jellyfin, applications Nextcloud et outils mailcow sur votre serveur ;
- le diagnostic de problèmes avec Emby Server, Jellyfin, Nextcloud, mailcow, les proxys inverses, Docker et le système Linux qui les entoure ;
- le déplacement d'une licence vers un nouveau serveur, les mises à niveau et les sauvegardes avant un changement important ;
- une revue rapide de votre installation avec des recommandations écrites.
Si une demande consiste à construire quelque chose de nouveau plutôt qu'à réparer ou configurer l'existant, elle relève du travail de développement. Vos heures restantes peuvent aussi y servir.
Conseils et dépannage
- Faites d'abord les cinq vérifications. Journaux, ports, certificats, disque et versions résolvent une grande partie des cas de « ça ne s'affiche pas » avant même d'avoir besoin d'une session.
- Changez une chose à la fois. Si vous avez modifié une règle de proxy et mis à jour un plugin le même soir, vous ne saurez pas lequel a cassé quelque chose.
- Faites une sauvegarde avant les grands changements. Les mises à niveau et migrations sont bien plus sereines avec une sauvegarde récente, et une revue de sauvegarde est une raison légitime de réserver une session.
- Gardez le solde en tête. Comme la facturation se fait par tranches de 15 min, une session courte et ciblée sur un problème précis suffit souvent. Le temps restant ne disparaît pas après la session.
- Utilisez les canaux gratuits pour les questions simples. L'e-mail et les tickets sont le bon endroit pour les questions rapides ; les heures servent au travail en prise en main.
- Reprogrammez tôt. Vous pouvez déplacer une session jusqu'à 2 fois, mais planifiez les changements au moins 24 heures à l'avance pour ne pas perdre le créneau.
D'autres ressources sont disponibles dans notre base de connaissances, et les questions courantes trouvent réponse dans la FAQ. Si vous n'êtes pas sûr que votre cas nécessite une session, contactez-nous.
Conclusion
La plupart des problèmes où « jellyfin ne fonctionne pas » se règlent avec les journaux, une vérification des ports, une vérification des certificats, une vérification du disque et une note de vos versions. Quand cela ne suffit pas, une session de support vous offre un second regard sur Telegram, une prise en main à distance seulement quand elle aide et seulement tant que vous l'autorisez, et une facturation par tranches de 15 min pour ne payer que le temps réellement utilisé. Commencez par les vérifications, puis réservez des heures sur la page Support technique si vous voulez de la compagnie sur le serveur.