Les données Immich obsolètes après un changement de chemin de stockage peuvent avoir trois causes distinctes qu’il ne faut pas confondre : le déplacement d’une racine de médias gérés, la modification du chemin d’importation d’une bibliothèque externe ou l’affichage d’un état mis en cache par un client. Les versions modernes d’Immich peuvent réconcilier le déplacement d’un emplacement de médias gérés si l’emplacement configuré et le montage du volume restent cohérents, tandis que les déplacements de bibliothèques externes peuvent toujours être interprétés comme la création de nouveaux éléments.
Conservez l’ancien chemin et la base de données avant de relancer l’analyse. Commencez par vérifier le chemin visible par le conteneur en cours d’exécution, puis déterminez si l’enregistrement côté serveur d’Immich est incorrect ou si un seul client affiche des données obsolètes. Cette distinction vous indiquera s’il faut corriger un montage, rétablir un chemin stable visible dans le conteneur, analyser un sous-ensemble de test ou vider uniquement le cache client.
Distinguez le déplacement d’une racine de médias gérés de celui d’une bibliothèque externe
Si vous avez modifié l’emplacement hôte des fichiers téléversés gérés par Immich, vérifiez que le paramètre effectif d’emplacement des médias et le montage entre l’hôte et le conteneur ont été modifiés ensemble. Un déplacement moderne des médias gérés ne doit pas être diagnostiqué comme le renommage d’un chemin d’importation de bibliothèque externe.
La carte de l’état persistant d’Immich de ZimaSpace est utile ici, car la base de données et les chemins du système de fichiers forment une seule frontière de récupération. Les bons fichiers sur l’hôte ne suffisent pas si le conteneur est monté à un autre emplacement.
Si la racine des médias gérés ne correspond pas, corrigez d’abord l’environnement et le mappage des volumes, puis redémarrez le service avant de lancer les tâches de bibliothèque. Si le chemin modifié appartient à une bibliothèque externe, conservez la base de données intacte et testez ce cas séparément.
Conservez si possible un chemin stable dans le conteneur pour la bibliothèque externe
Pour une bibliothèque externe, le plus sûr est de déplacer le stockage côté hôte tout en conservant le chemin d’import visible dans le conteneur. Si le chemin présenté à Immich change, notez quelques identifiants de fichiers, albums, personnes et anciens chemins avant l’analyse. Vous pourrez ainsi vérifier si les éléments existants ont été reliés à nouveau ou recréés.
Un rapport sur le changement de chemin d’une bibliothèque externe Immich décrit des fichiers déplacés considérés comme de nouveaux éléments, entraînant un retraitement et la perte de relations propres à Immich. Ce cas concerne une version précise, mais il confirme la règle de prudence : un changement de chemin dans une bibliothèque externe n’est pas automatiquement interprété comme un simple renommage.
Si un sous-ensemble de test apparaît comme de nouveaux éléments tandis que les anciens enregistrements sont considérés comme manquants ou mis à la corbeille, arrêtez l’analyse complète. Si possible, rétablissez l’ancien chemin visible par le conteneur ou utilisez une méthode de migration adaptée à la version ; ne réécrivez pas manuellement les chemins dans la base de données de production sans sauvegarde testée.
Ne confondez pas ce cas avec une migration du modèle de stockage pour les fichiers gérés par Immich. Le symptôme peut sembler similaire dans la chronologie, mais la propriété des fichiers et la procédure de migration prise en charge sont différentes.
Distinguez les chemins enregistrés sur le serveur du cache client
Inspectez le même élément connu depuis le client Web et un autre client authentifié, puis comparez le résultat aux journaux du serveur ou au chemin visible par celui-ci. Si les tâches côté serveur indiquent toujours l’ancien chemin, vider le cache du navigateur ne corrigera pas l’enregistrement sous-jacent.
Un problème ultérieur de métadonnées liées à un ancien chemin dans Immich a montré que le traitement continuait de référencer un ancien chemin de bibliothèque externe après un renommage. C’est un indice fort qu’il faut vérifier les chemins utilisés par les tâches avant d’incriminer l’interface mobile ou Web.
Si le chemin du serveur est correct, mais qu’une seule vue Web est obsolète, actualisez ou videz le cache de ce client, puis retestez le fichier d’origine. Des miniatures mises en cache et un état client obsolète peuvent donner l’impression que le serveur corrigé ne fonctionne pas. À l’inverse, un aperçu en cache peut faire paraître sain un chemin serveur défectueux.
Réparez la limite de chemin la plus restreinte et validez une nouvelle analyse contrôlée
Effectuez une seule correction réversible : synchronisez le paramètre du média géré et le point de montage, rétablissez l’ancien chemin de bibliothèque externe dans le conteneur, corrigez un chemin d’importation ou videz un cache client. Sauvegardez la base de données avant toute action susceptible d’entraîner la redécouverte d’une grande bibliothèque.
Lancez la plus petite nouvelle analyse possible et vérifiez si les enregistrements existants restent associés, si les erreurs liées aux anciens chemins cessent et si aucun doublon d’éléments avec l’ancien et le nouveau chemin n’apparaît. Ouvrez ensuite quelques originaux, vérifiez les relations avec les albums et les personnes, lancez une recherche et redémarrez la pile.
Signalez le problème si les anciennes et nouvelles entrées de chemin restent actives simultanément, si une grande bibliothèque externe est retraitée de manière inattendue ou si des relations disparaissent alors que les originaux restent lisibles. Conservez une trace exacte de la correspondance des points de montage avant/après, de la version d’Immich, des identifiants des éléments concernés, du comportement de la casse du système de fichiers et de l’horodatage de la sauvegarde de la base de données.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



