Jellyfin sur Linux

Jellyfin est un serveur médias (films, séries, musique) open source, alternatif à Plex/Emby. Ce guide décrit l’installation sur Debian/Ubuntu via le dépôt officiel, la configuration de base, un reverse proxy Nginx, les bibliothèques et le dépannage. Alternative en Docker : install-docker-linux. Pour Nginx : nginx-phpfpm-linux.

Prérequis

• Debian 11/12 ou Ubuntu 20.04/22.04
• Accès root ou sudo
• Connexion Internet

1. Dépôt et installation

• Import de la clé et dépôt (à adapter si la procédure officielle change) :

sudo apt install apt-transport-https ca-certificates curl gnupg
curl -fsSL https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/jellyfin.gpg
echo "deb [signed-by=/usr/share/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list
sudo apt update
sudo apt install jellyfin

• Pour Debian : remplacer ubuntu par debian dans l’URL du dépôt si un dépôt Debian est proposé ; sinon, vérifier la doc Jellyfin.

2. Démarrer et accès

sudo systemctl enable jellyfin
sudo systemctl start jellyfin

• Interface web : http://IP_du_serveur:8096.
• Assistant : langue, compte admin, bibliothèques (dossiers Films, Séries, etc.).

3. Reverse proxy (Nginx)

• Exposer Jellyfin en HTTPS (ex. jellyfin.votredomaine.com) :

server {
    listen 80;
    server_name jellyfin.votredomaine.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name jellyfin.votredomaine.com;
    ssl_certificate /etc/letsencrypt/live/jellyfin.votredomaine.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/jellyfin.votredomaine.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8096;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

• Paramètres Jellyfin : Réseau → Adresses de base (base URL) : https://jellyfin.votredomaine.com si besoin.

4. Bibliothèques

• Tableau de bord → Bibliothèques → Ajouter : type (Films, Séries, Musique, etc.), dossiers (ex. /srv/media/films, /srv/media/series).
• Numérotation pour les séries : S01E01, etc. Métadonnées : Jellyfin récupère infos et posters (TMDB, etc.).

5. Alternative Docker

• Image : jellyfin/jellyfin. Exemple :

docker run -d --name jellyfin -p 8096:8096 -v jellyfin_config:/config -v /srv/media:/media jellyfin/jellyfin

• /config : config et cache. /media : vos dossiers de médias (adapter les chemins).
• Voir install-docker-linux.

Dépannage

Bonnes pratiques

• Sauvegarder le répertoire de config (/var/lib/jellyfin ou le volume Docker).
• HTTPS en production ; restreindre l’accès (VPN, IP) si le serveur est exposé.
• Pour Docker : install-docker-linux. Pour Nginx : nginx-phpfpm-linux.

Ressources

• Jellyfin – Installation Linux
• Jellyfin – Docker

Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.