Migrer Plex vers Jellyfin et Navidrome sur VPS

Pourquoi quitter Plex en 2026 : 36 000 serveurs exposés

Ce que Plex cache derrière son modèle cloud

• Accès distant via Plex Relay : chaque flux transite par les serveurs plex.tv, même si votre VPS est le seul à stocker les fichiers. Plex voit vos métadonnées de lecture.
• Plex Pass obligatoire pour les fonctions clés : synchronisation hors ligne, accès multi-utilisateurs complet, Live TV et accès distant sans port forwarding sont réservés aux abonnés payants.
• Authentification centralisée : la connexion de vos clients passe par les serveurs Plex. Une panne plex.tv vous coupe de vos propres fichiers.
• Mise à jour non contrôlée : Plex peut déployer des changements côté serveur (relay, authentification) sans que vous puissiez les auditer ni les bloquer.
• Télémétrie active par défaut : lecture, recherches et habitudes de visionnage remontent vers l'éditeur sauf désactivation manuelle dans chaque client.

Prérequis avant de commencer la migration

Migration Plex → Jellyfin : procédure étape par étape

1. 01

   Créer un snapshot VPS

   Avant tout : snapshot create plex-before-migration depuis votre panneau fournisseur (ou équivalent API). Cette étape est le filet de sécurité ; ne la sautez pas.

2. 02

   Arrêter Plex proprement

   systemctl stop plexmediaserver
   systemctl disable plexmediaserver

   Attendez la confirmation de l'arrêt avant de continuer. Plex ne doit plus écouter sur le port 32400.

3. 03

   Installer Jellyfin via Docker Compose

   # /opt/jellyfin/docker-compose.yml
   services:
     jellyfin:
       image: jellyfin/jellyfin:latest
       container_name: jellyfin
       restart: unless-stopped
       ports:
         - "8096:8096"
       volumes:
         - /opt/jellyfin/config:/config
         - /opt/jellyfin/cache:/cache
         - /data/media:/media:ro
       environment:
         - JELLYFIN_PublishedServerUrl=https://jellyfin.votre-domaine.com

   Remplacez /data/media par le chemin exact de vos fichiers médias. Le volume est monté en lecture seule (:ro) par précaution.

4. 04

   Démarrer Jellyfin et lancer l'assistant d'initialisation

   cd /opt/jellyfin && docker compose up -d

   Accédez à http://IP-DU-VPS:8096 pour l'assistant web. Créez le compte administrateur, puis ajoutez vos bibliothèques en pointant vers /media/films, /media/series, etc.

5. 05

   Scanner les bibliothèques et vérifier les métadonnées

   Jellyfin utilise The Movie Database (TMDB) et TheTVDB par défaut. Le premier scan complet prend entre 5 et 30 minutes selon la taille de votre bibliothèque. Vérifiez que les jaquettes, les synopsis et les notes s'affichent correctement. Si une œuvre n'est pas reconnue automatiquement, utilisez la fonction "Identifier" pour forcer la correspondance.

6. 06

   Configurer les clients Jellyfin

   Les applications officielles Jellyfin existent sur Android, iOS, Apple TV, Android TV, Roku et les navigateurs. Elles sont gratuites et open source. Pointez chaque client vers l'URL interne ou publique de votre serveur — aucune authentification tierce n'est requise.

7. 07

   Vérifier les transcoding et les sous-titres

   Dans Tableau de bord > Lecture, activez le transcoding matériel si votre VPS dispose d'un GPU (Intel Quick Sync, NVIDIA NVENC). Testez un fichier H.265 depuis un client mobile pour valider que le transcodage logiciel fonctionne en fallback. Vérifiez également que les sous-titres SRT et ASS/SSA s'affichent.

8. 08

   Supprimer Plex

   apt remove plexmediaserver --purge
   rm -rf /var/lib/plexmediaserver

   Ne supprimez l'ancienne installation qu'après avoir validé Jellyfin sur au moins un client pendant 48 heures.

Migration musicale : Plex → Navidrome

1. 09

   Vérifier la structure des dossiers

   Navidrome s'attend à une hiérarchie Artiste/Album/Piste.mp3. Si vos fichiers sont déjà organisés ainsi (ce qu'impose également Plex), aucune réorganisation n'est nécessaire. Vérifiez l'absence de caractères spéciaux dans les noms de dossiers (/, :, ?).

2. 10

   Auditer les tags ID3

   find /data/music -name '*.mp3' | head -20 | xargs id3v2 -l

   Les champs TPE1 (artiste), TALB (album) et TIT2 (titre) doivent être renseignés. Un fichier sans ces trois tags sera importé mais sans métadonnée affichable. L'outil beets peut corriger les tags manquants en masse via sa base MusicBrainz.

3. 11

   Déployer Navidrome via Docker Compose

   # /opt/navidrome/docker-compose.yml
   services:
     navidrome:
       image: deluan/navidrome:latest
       container_name: navidrome
       restart: unless-stopped
       ports:
         - "4533:4533"
       volumes:
         - /opt/navidrome/data:/data
         - /data/music:/music:ro
       environment:
         - ND_SCANSCHEDULE=1h
         - ND_LOGLEVEL=info
         - ND_BASEURL=

   Démarrez avec docker compose up -d puis accédez à http://IP:4533 pour créer le premier compte.

4. 12

   Migrer les playlists Plex

   Plex n'exporte pas les playlists au format M3U nativement depuis l'interface. Utilisez l'outil plexapi (Python) pour exporter : python3 -m plexapi.playlist export --token VOTRE_TOKEN --output /data/music/playlists/. Les fichiers M3U générés sont importés automatiquement par Navidrome si les chemins sont relatifs au volume /music.

Comparaison Plex, Jellyfin et Navidrome

Faites défiler le tableau

Configuration Nginx en reverse proxy pour Jellyfin

# /etc/nginx/sites-available/jellyfin
server {
    listen 80;
    server_name jellyfin.votre-domaine.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name jellyfin.votre-domaine.com;

    ssl_certificate /etc/letsencrypt/live/jellyfin.votre-domaine.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/jellyfin.votre-domaine.com/privkey.pem;

    # Headers de sécurité
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";
    add_header X-XSS-Protection "1; mode=block";

    location / {
        proxy_pass http://127.0.0.1:8096;
        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;

        # WebSocket pour la diffusion
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Buffers pour les flux vidéo
        proxy_buffering off;
        proxy_read_timeout 3600;
    }
}

Dépannage : les 3 erreurs les plus fréquentes

• Bibliothèque vide après le premier scan : vérifiez que le chemin monté dans Docker correspond exactement au répertoire contenant vos fichiers. docker exec jellyfin ls /media doit lister vos dossiers. Si le volume est vide, corrigez le mapping dans docker-compose.yml et redémarrez le conteneur.
• Transcoding échoue avec erreur ffmpeg : Jellyfin embarque sa propre version de ffmpeg. Si le conteneur ne dispose pas d'accès au GPU, désactivez le transcoding matériel dans Tableau de bord > Lecture et passez en transcoding logiciel. Sur un VPS sans GPU, c'est la configuration normale.
• Clients iOS/Android ne trouvent pas le serveur : assurez-vous que le pare-feu autorise le port 443 depuis l'extérieur (ufw allow 443), que votre DNS pointe vers l'IP du VPS, et que le certificat TLS est valide. Testez avec curl -I https://jellyfin.votre-domaine.com/health depuis votre poste local.

Conclusion