Comment déplacer les données de l’application Plex sans perdre l’historique de visionnage ni les paramètres

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.

Déplacez le répertoire complet de données du serveur Plex lorsque Plex est arrêté, laissez la source intacte et vérifiez le serveur migré avant de supprimer ou de réutiliser l’ancienne copie.

L’historique de visionnage Plex, les métadonnées, l’état de la base de données, les préférences et les autres informations du serveur se trouvent dans le répertoire de données du serveur, et non dans vos dossiers de films. Dans Docker, ce répertoire correspond au chemin hôte ou au volume que vous avez associé au chemin de configuration de Plex. Une migration sûre consiste donc à déplacer l’état, et non à réanalyser la bibliothèque multimédia : bloquez les écritures, copiez les bonnes données, préservez les droits de propriété, indiquez le nouvel emplacement au conteneur et vérifiez que l’identité de l’ancien serveur ainsi que l’état de visionnage ont été conservés.

Protégez la source avant toute opération

Commencez par identifier le chemin hôte qui correspond à la configuration persistante de Plex et effectuez-en une sauvegarde distincte. Ne commencez pas par modifier le montage du conteneur en espérant que le nouvel emplacement soit correct. Notez le montage actuel, la version de Plex, le nom du serveur, les chemins des médias et les droits de propriété afin de pouvoir revenir à la configuration fonctionnelle connue si la nouvelle copie ne démarre pas correctement.

Les instructions de Plex relatives à la migration d’un serveur demandent explicitement aux utilisateurs d’arrêter le serveur avant de copier ses données et signalent que la migration peut avoir des limites, notamment entre différents systèmes d’exploitation. Elles avertissent également que les accès existants à la bibliothèque accordés à d’autres comptes Plex ne sont pas toujours conservés. L’accès des utilisateurs partagés doit donc être vérifié après la migration, plutôt que promis systématiquement dans le titre.

Conservez l’ancien répertoire de données en lecture seule ou, à défaut, ne le modifiez pas pendant le premier test. Une restauration est facile lorsque la source existe encore : arrêtez Plex, rétablissez le montage d’origine et démarrez avec l’ancien état. Elle devient beaucoup plus difficile après la suppression de la source ou si deux copies écrivent dans la même base de données.

Arrêtez Plex et copiez l’intégralité de l’état persistant

Arrêtez le conteneur Plex et vérifiez qu’il n’effectue plus aucune écriture avant de commencer la copie. Copiez l’intégralité du répertoire de données persistantes du serveur vers le nouvel emplacement de stockage. Pour les grandes bibliothèques, préservez les attributs des fichiers et envisagez une méthode de copie par archive ou propre au système de fichiers, capable de gérer efficacement les nombreux petits fichiers de métadonnées.

Si vous n’êtes pas certain de l’emplacement du véritable état Plex, consultez la référence de Plex sur le répertoire de données afin de distinguer les données du serveur du contenu multimédia. Dans Docker, l’emplacement effectif dépend du volume ou du montage lié que vous avez choisi ; la configuration du conteneur fait donc autorité pour déterminer le chemin hôte.

Après la copie, attribuez au nouveau chemin les mêmes propriétaire et groupe effectif que ceux utilisés précédemment par Plex, et rendez-le accessible en écriture. Une copie complète avec des droits incorrects peut donner l’impression d’une perte de données, car Plex peut démarrer avec un répertoire vierge ou partiellement lisible. Corrigez les accès avant d’autoriser Plex à créer un nouvel état dans la destination.

Indiquez le nouveau chemin à Plex et vérifiez l’identité avant toute analyse

Commencez par modifier uniquement le montage des données de configuration ; ne renommez pas simultanément les dossiers multimédias, ne changez pas le mode réseau, ne mettez pas Plex à jour et ne déplacez pas le stockage. Démarrez le conteneur et ouvrez Plex. Le serveur doit apparaître avec le nom attendu, ses bibliothèques, ses affiches, son historique de visionnage, ses paramètres et son identité précédente, au lieu de vous demander de créer un serveur entièrement nouveau.

Dans le cadre d’une migration vers un NAS, le guide ZimaSpace sur la migration des données d’un NAS suit le même ordre de protection : sauvegarder d’abord, déplacer un périmètre défini, vérifier la destination, puis seulement supprimer l’ancienne copie. Cet ordre compte davantage que le fait d’effectuer le déplacement depuis une interface ou avec une commande shell.

Avant de lancer une analyse générale de la bibliothèque, ouvrez plusieurs éléments dont vous connaissez l’état visionné ou non visionné et comparez-les avec la source. Vérifiez les paramètres du serveur ainsi qu’au moins un utilisateur partagé ou un compte géré. Si l’identité, l’historique ou les autorisations sont incorrects, arrêtez-vous ici et effectuez une restauration au lieu d’autoriser les analyses à réécrire davantage de données.

-15% OFF

Vérifiez la persistance après un redémarrage avant de supprimer l’ancienne copie

Redémarrez le conteneur Plex et répétez les vérifications. Confirmez que le nouveau montage correspond toujours au chemin hôte actif et que les nouvelles modifications de l’état de visionnage y sont bien enregistrées. Lancez ensuite brièvement la lecture d’un élément, arrêtez-la, puis vérifiez que l’indicateur de progression est conservé après un autre redémarrage de Plex. Vous confirmerez ainsi que la destination n’est pas seulement lisible, mais qu’elle reçoit également les écritures actuelles.

Si les chemins des médias ont également changé, migrez-les séparément et utilisez la procédure de Plex relative à l’emplacement des médias, plutôt que de confondre la migration de l’état de l’application avec celle du contenu. Séparer ces deux opérations facilite le diagnostic des erreurs et évite de prendre un montage multimédia manquant pour une perte de la base de données Plex.

Ne supprimez ou ne réutilisez l’ancienne copie des données de l’application qu’après avoir vérifié que le nouvel emplacement fonctionne après un redémarrage et une utilisation normale. Si les utilisateurs partagés ou les autorisations des bibliothèques n’ont pas été transférés, corrigez-les explicitement une fois l’état du serveur stabilisé ; ne détruisez pas la source simplement parce que l’historique de visionnage et les paramètres principaux semblent corrects.

Assistance et conseils

Plus à lire

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.