Solution communautaire

Reconnecter Immich aux photos existantes après une réinitialisation de ZimaOS : protéger pgdata et l’upload avant de remapper les chemins d’accès

A June-July 2026 thread where a ZimaOS reset preserved a RAID6 and its old Immich folders, but reinstalling Immich did not reconnect the existing photo library. The old /media/photos/immich/upload and pgdata folders still existed. Community replies emphasized protecting both and verifying Docker's actual mounts. The user ultimately abandoned that recovery attempt without confirming a fix.

Les données sources n’étaient manifestement pas perdues. Après une réinitialisation de ZimaOS, le RAID6 existait toujours et des répertoires tels que téléversement, pgdata, miniatures, profil, et encoded-video étaient toujours présents. Le problème était que la pile Immich réinstallée n’était pas reliée à l’ancien état de la base de données et de la bibliothèque de manière à restaurer l’ancien catalogue photo.

Le conseil le plus prudent de la source était le suivant : ne supprimez pas et ne déplacez pas encore les anciens dossiers upload et pgdata. Immich ne reconstruit pas l’intégralité de son catalogue en détectant simplement les fichiers image sur le disque. La base de données contient les chemins des fichiers, les utilisateurs, les albums, les métadonnées et l’état de l’application. La documentation actuelle d’Immich v3 explicite cette relation et recommande de sauvegarder à la fois les fichiers multimédias et la base de données.

Commencer par confirmer le véritable chemin de montage du RAID

La source utilisait :

ls -la /media
find /media -maxdepth 4 -type d \( -iname "immich" -o -iname "pgdata" -o -iname "upload" \)

et a trouvé :

/media/photos/immich
/media/photos/immich/pgdata
/media/photos/immich/upload

Cela a établi que les anciens dossiers Immich existaient toujours sur le RAID.

L’utilisateur était alarmé par ceci :

/media/ZimaOS-HD -> /DATA

mais la communauté a correctement expliqué qu’il s’agit d’une relation de montage/de lien symbolique propre à ZimaOS. Sa présence ne vous indique pas quels chemins hôtes les conteneurs Immich utilisent réellement.

Inspecter les montages effectifs de Docker

La discussion recommandait de vérifier :

docker inspect immich-server --format '{{json .Mounts}}'
docker inspect immich-postgres --format '{{json .Mounts}}'

C’est plus fiable que de supposer qu’une capture d’écran ou un ancien souvenir reflète la configuration du conteneur en cours d’exécution.

Paramètres du serveur Immich dans ZimaOS affichant les chemins hôtes sous /media/photos/immich associés à des chemins de conteneur tels que upload, thumbs, profile, model-cache, library, encoded-video et backups
La source montre que les anciens dossiers RAID ont été associés au nouveau conteneur du serveur Immich, mais l’association des fichiers seule n’a pas restauré l’ancien catalogue de la base de données.

L’ancien pgdata est aussi important que les anciens fichiers photo

Mappage des paramètres de la base de données Immich dans ZimaOS, de /media/photos/immich/pgdata vers le répertoire de données Postgres
Le mappage de la base de données est essentiel, car Immich stocke le catalogue et les métadonnées qui associent les utilisateurs aux fichiers sur le disque.

Si la réinstallation a initialisé une base de données entièrement nouvelle au lieu de l’ancienne, les fichiers peuvent toujours être présents alors qu’Immich semble vide.

Immich utilise actuellement UPLOAD_LOCATION et DB_DATA_LOCATION

La configuration Compose actuelle d’Immich v3 sépare l’emplacement des ressources sur l’hôte et l’emplacement de Postgres à l’aide de UPLOAD_LOCATION et DB_DATA_LOCATION. Le projet indique explicitement que les partages réseau ne sont pas pris en charge pour le chemin de la base de données.

Utilisez le modèle de stockage actuel d’Immich.

Une sauvegarde de base de données est plus sûre que le rattachement d’un ancien répertoire pgdata actif entre différentes versions

La source utilisait Immich v2.7.2. La version actuelle d’Immich est la v3. Lors d’une récupération entre différentes versions, le processus de sauvegarde et de restauration de la base de données recommandé par le projet est plus sûr que de supposer qu’un ancien répertoire de données Postgres peut simplement être attaché à une image de base de données plus récente.

Consultez la procédure actuelle de sauvegarde et de restauration d’Immich.

Ne réorganisez pas manuellement les dossiers internes de ressources d’Immich

La documentation actuelle d’Immich avertit que des dossiers tels que bibliothèque, téléversement, miniatures, profil, et encoded-video sont gérés par l’application. Déplacer ou supprimer des fichiers individuels derrière Immich peut créer des ressources manquantes ou non suivies.

L’utilisateur source n’a pas confirmé la réussite de la récupération

Des membres de la communauté ont proposé plusieurs approches de mappage, notamment un montage parent unique, mais jerlo a finalement mis le problème de côté et a recommencé sur un autre système. Le forum ne valide donc aucun mappage de chemins comme solution définitive.

Immich privilégie actuellement une racine de téléversement gérée plutôt que le mappage manuel de chaque dossier enfant

Les captures d’écran sources mappaient manuellement téléversement, miniatures, profil, bibliothèque, encoded-video, ainsi que les sauvegardes, une par une. Le fichier Compose actuel en amont se concentre plutôt sur la configuration de l’hôte pour UPLOAD_LOCATION, Immich gérant ses répertoires enfants internes sous cette racine.

Lors d’une reconstruction avec une version plus récente d’Immich, utilisez la structure actuelle de Compose/du stockage au lieu de reproduire un ensemble historique de mappages enfants, sauf si le paquet l’exige spécifiquement.

Conservez le chemin des données PostgreSQL sur un stockage local pris en charge

La documentation actuelle d’Immich indique explicitement que les partages réseau ne sont pas pris en charge pour DB_DATA_LOCATION. Un système de fichiers RAID/stockage attaché localement peut convenir, mais un répertoire de base de données monté via SMB/NFS n’est pas un chemin de base de données pris en charge.

Une récupération complète d’Immich nécessite à la fois les ressources et la base de données

La documentation actuelle d’Immich indique que les sauvegardes de bases de données contiennent les métadonnées et les informations utilisateur, mais pas les fichiers photo/vidéo. L’arborescence des ressources doit être sauvegardée séparément et restaurée avec une sauvegarde de base de données compatible.

Cela explique pourquoi, dans le cas source, le fait que « les fichiers téléversés soient toujours là » était rassurant, mais insuffisant.

N’attachez pas à la légère un ancien répertoire pgdata actif à une version différente de PostgreSQL ou de l’image

Un répertoire de données PostgreSQL brut dépend de la version. Si l’ancien environnement et le nouveau paquet utilisent des versions différentes de PostgreSQL ou d’Immich, privilégiez un vidage/restauration de la base de données pris en charge ou une procédure de migration documentée. Effectuez une sauvegarde octet par octet de l’ancien pgdata avant de faire des essais.

FAQ sur la récupération d’Immich

La réinitialisation de ZimaOS a-t-elle effacé les dossiers photo sources du RAID6 ?

Non. L’utilisateur a indiqué que le RAID et les répertoires/fichiers existants étaient restés intacts.

Le simple mappage des anciens fichiers photo restaurera-t-il la bibliothèque Immich ?

Pas nécessairement. Immich a également besoin de l’état correspondant de la base de données et du catalogue.

Que faut-il protéger avant de faire des essais ?

L’ensemble des fichiers de ressources ainsi que la base de données ou une sauvegarde vérifiée de celle-ci.