Pourquoi Immich perd-il l’accès aux données persistantes après la recréation de la pile ?

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Quand Immich semble vide ou ne parvient pas à lire sa bibliothèque après la recréation de la stack, partez du principe que les anciennes données persistantes sont déconnectées ou illisibles avant de supposer qu’elles ont été supprimées.

La recréation des conteneurs peut modifier l’identité du projet Compose, la source du montage lié, l’association du volume nommé, le moment de disponibilité du partage réseau ou l’UID/GID utilisé pour accéder aux données. Arrêtez l’instance qui semble neuve avant qu’elle n’écrive beaucoup de nouvelles données, localisez sur l’hôte les anciens chemins de la base de données et des médias, puis comparez la stack recréée avec le dernier mappage connu comme valide. L’objectif est d’abord de reconnecter les données existantes ; ne restaurez une sauvegarde qu’après avoir prouvé que ces données sont réellement manquantes ou endommagées.

Arrêter la nouvelle instance et prouver que les anciennes données existent toujours

Un assistant de configuration, une chronologie vide ou une bibliothèque externe manquante juste après la recréation est un signe d’alerte concernant la persistance. Arrêtez Immich et inspectez les emplacements de la base de données et des médias sur l’hôte avant de téléverser de nouveaux fichiers ou d’accepter une nouvelle configuration vide. De nouvelles écritures peuvent compliquer les comparaisons de chemins ultérieures.

Vérifiez dans les anciens répertoires le nombre de fichiers attendu, les dates de modification, les fichiers ou sauvegardes de la base de données et quelques images d’origine représentatives. Si les données sont présentes sur l’hôte, le problème concerne l’accès ou le mappage, pas leur disparition. Créez un instantané ou une sauvegarde en lecture seule de cet état avant de modifier les propriétaires ou de déplacer les répertoires.

Si les anciennes données sont introuvables aux chemins attendus, recherchez dans le pool de stockage et l’inventaire des volumes Docker avant de supprimer quoi que ce soit. La décision est binaire : soit l’état existant est localisé et protégé, soit il est réellement indisponible et la procédure de récupération passe alors par une sauvegarde connue comme valide plutôt que par la réparation des montages.

Comparer les montages recréés avec ceux de l’ancienne stack

Inspectez les montages effectifs des conteneurs Immich et de base de données recréés, pas seulement le texte Compose dont vous vous souvenez avoir modifié. Un chemin relatif de montage lié peut être résolu depuis un autre répertoire de projet, et un projet Compose renommé peut rattacher un nouveau volume nommé tout en laissant l’ancien intact, mais inutilisé.

Un montage qui a échoué, a changé ou est manquant peut apparaître comme un répertoire vide dans un conteneur, même si les données attendues existent toujours ailleurs sur l’hôte. Utilisez les vérifications des montages de volumes Docker pour comparer Source, Destination, le type de montage et l’identité du volume nommé pour chaque chemin Immich persistant. Une discordance à ce niveau explique directement pourquoi l’instance semble neuve.

Corrigez uniquement le mauvais mappage de montage, puis créez ou démarrez le conteneur sans supprimer de volumes. Si les fichiers attendus apparaissent au même chemin dans le conteneur après la modification, laissez les données en place. Si la liste des montages est correcte mais que l’accès échoue toujours, conservez le mappage et vérifiez la disponibilité du stockage hôte et les permissions au lieu de créer un autre volume.

Vérifier que le stockage externe était monté avant le démarrage d’Immich

Si les données d’Immich se trouvent sur un pool de disques durs, un partage NAS, une couche merger ou un autre montage externe, vérifiez que ce stockage est effectivement monté sur l’hôte avant le démarrage de la pile Docker. Un chemin comme /mnt/photos peut toujours exister en tant que répertoire local ordinaire lorsque le périphérique réel est absent.

Les données Docker persistantes ne survivent au remplacement d’un conteneur que si le volume prévu ou le montage lié est correctement rattaché. Le modèle de persistance des volumes Docker ne fait pas apparaître automatiquement un disque hôte ou un partage réseau manquant : vérifiez donc le périphérique de stockage et un fichier connu sur l’hôte avant de tester le même chemin dans Immich.

Si vous découvrez des fichiers de secours écrits dans le point de montage nu alors que le stockage réel était absent, arrêtez Immich avant de monter l’appareil par-dessus. Traitez ces fichiers séparément, ajoutez une dépendance au démarrage ou un contrôle d’intégrité pour le montage du stockage, puis redémarrez la pile. Si le stockage de l’hôte est stable et que le chemin du conteneur reste illisible, passez à la vérification des permissions.

Vérifier l’UID, le GID et les permissions des répertoires sans tout réécrire

Une pile recréée peut exécuter un service avec une identité numérique, un espace de noms utilisateur ou un contexte de sécurité différent de l’ancien. Le résultat diffère de celui d’un montage manquant : le chemin existe et les fichiers sont visibles depuis l’hôte, mais les journaux d’Immich indiquent des erreurs d’autorisation ou le service ne peut pas créer les fichiers attendus.

Comparez la propriété numérique et les bits de mode des répertoires de l’hôte concernés avec l’identité de l’utilisateur dans le conteneur recréé. Testez d’abord une lecture sans risque, puis une écriture réversible dans un emplacement temporaire sous le même montage. Évitez de modifier récursivement la propriété de toute l’archive photo avant de savoir quel service a besoin d’un accès en écriture et quels fichiers d’origine doivent rester intacts.

Corrigez le problème minimal de répertoire ou d’identité qui explique la défaillance, redémarrez une fois et vérifiez à nouveau les journaux. Si l’accès échoue toujours malgré des montages et des autorisations correspondants, cessez de modifier le système de fichiers et examinez la connexion à la base de données, la substitution des variables d’environnement ou la couche de sécurité qui a changé lors de la recréation.

Reconnecter l’état d’origine et valider une autre recréation

Une fois les anciens chemins de la base de données et des fichiers multimédias montés et accessibles en lecture, démarrez Immich et recherchez les anciens utilisateurs, albums, personnes et quelques fichiers représentatifs. Ne considérez pas la réparation comme terminée simplement parce que la page d’accueil se charge ; vérifiez que l’application lit bien l’état d’origine et non une base de données nouvellement initialisée à côté.

La distinction utile est que les conteneurs peuvent être éphémères, tandis que l’état de l’application doit rester sur un stockage stable, indépendant du cycle de vie des conteneurs. Documentez les noms de montage et les chemins de l’hôte corrigés, et utilisez des rôles de stockage persistant de serveur de fichiers pour que la prochaine recréation de la pile utilise les mêmes données.

Enfin, recréez la pile une fois de plus dans des conditions contrôlées et répétez les vérifications initiales. Le correctif n’est validé que si la même base de données et les mêmes fichiers multimédias réapparaissent après la recréation et après le redémarrage de l’hôte. Si l’ancien état disparaît à nouveau, ou si la base de données signale une corruption plutôt que des erreurs d’accès, revenez à la copie protégée et passez à la récupération de la base de données ou de la sauvegarde au lieu de poursuivre les essais de montage.

Assistance et conseils

À lire aussi

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.