Installer et optimiser Jellyfin sur Ubuntu : guide pas à pas

Installer Jellyfin avec la méthode officielle, organiser les bibliothèques et vérifier l’accélération matérielle.

Avant de commencer

Choisissez une version Ubuntu prise en charge par le dépôt Jellyfin, un compte sudo et assez d’espace pour médias, métadonnées et transcodage temporaire. Consultez la documentation de votre version. La lecture directe évite souvent le transcodage ; les performances dépendent du GPU, des codecs, des clients et du réseau.

Installer depuis le dépôt officiel

Téléchargez le script officiel et sa somme de contrôle, vérifiez le résultat OK, examinez le script, puis exécutez-le avec les privilèges nécessaires. Jellyfin documente également la configuration manuelle du dépôt. Contrôlez ensuite le service.

sudo apt update
sudo apt install curl ca-certificates
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh.sha256sum
sha256sum -c install-debuntu.sh.sha256sum
less install-debuntu.sh
sudo bash install-debuntu.sh
sudo systemctl status jellyfin --no-pager

Configuration initiale et accès

Sur un réseau fiable, ouvrez http://IP_SERVEUR:8096, créez un administrateur avec un mot de passe solide et configurez langue et bibliothèques. Accordez si possible un accès en lecture seule aux médias. N’exposez pas directement le port 8096 à Internet : utilisez un proxy inverse HTTPS ou un VPN, une authentification et des mises à jour régulières.

Accélération matérielle

Identifiez le GPU et les périphériques vidéo. Dans Dashboard > Playback > Transcoding choisissez la méthode documentée selon les pilotes : Intel QSV, AMD VA-API ou NVIDIA NVENC. Vérifiez l’accès de l’utilisateur jellyfin au périphérique. N’activez que les codecs et le tone mapping compatibles. Testez un fichier réellement transcodé et observez journaux et charges CPU/GPU. Aucun gain chiffré n’est garanti.

lspci -nn | grep -Ei '3d|display|vga'
ls -l /dev/dri/
id jellyfin

Stockage temporaire et bibliothèques

Ne déplacez pas automatiquement le transcodage vers /tmp ou la RAM : un tmpfs trop petit peut saturer la mémoire et interrompre la lecture. Dimensionnez espace, mémoire et flux simultanés, puis changez le chemin si les mesures le justifient. Planifiez les aperçus hors des heures de pointe et surveillez cache et permissions.

Fonctions et limites

Jellyfin propose bibliothèques, comptes, clients et extensions. Codecs, téléchargements hors ligne, SyncPlay et fonctions des clients varient selon appareil et version. Vérifiez les clients officiels avant un achat. Contrôlez et mettez à jour séparément les extensions tierces. Sauvegardez configuration, métadonnées et médias.

Sources officielles

Installation : https://jellyfin.org/docs/general/installation/linux/ ; transcodage : https://jellyfin.org/docs/general/post-install/transcoding/ ; accélération : https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/ .