Solution communautaire

Déplacer le stockage de photos Immich vers un NAS ou un disque plus grand sur ZimaOS

A March–April 2025 Immich storage thread where an IceWhale reply pointed users to Docker path mapping and a community member documented the exact host-side volume changes needed to move database, model cache, uploads, and selected media paths to larger storage.

Immich peut utiliser une grande quantité d’espace de stockage. Il est donc rarement idéal de laisser ses téléversements, sa base de données et son cache d’apprentissage automatique sur le disque système de ZimaOS lorsque votre photothèque s’agrandit.

Cette discussion de 2025 décrit une méthode manuelle pour déplacer Immich vers un autre emplacement de stockage de ZimaOS en modifiant les mappages de volumes côté hôte. Les versions actuelles de ZimaOS proposent également des contrôles plus directs pour choisir l’emplacement de stockage et effectuer une migration. Les captures d’écran de la méthode manuelle doivent donc surtout être considérées comme une explication de la correspondance entre les chemins du conteneur.

Ouvrir les paramètres d’Immich avant de modifier les volumes

Menu de l’application Immich dans ZimaOS, avec l’option Paramètres mise en évidence avant la modification des volumes de stockage
La procédure de la communauté commençait par l’ouverture des paramètres de l’application Immich installée, plutôt que par un déplacement manuel des dossiers dans Fichiers.

Déplacer le chemin hôte de la base de données, pas le chemin du conteneur

Mappage du volume de la base de données Immich avec un chemin hôte sur /media/Main et le chemin du conteneur PostgreSQL laissé inchangé
La configuration fonctionnelle de la communauté modifiait le côté ZimaOS du mappage de la base de données, tout en laissant inchangée la destination du conteneur PostgreSQL.

Cette distinction entre l’hôte et le conteneur est essentielle. L’application attend des chemins précis à l’intérieur de ses conteneurs. Modifier les deux côtés sans comprendre la structure de la pile peut empêcher le démarrage ou donner l’impression que les données existantes ont disparu.

Le cache d’apprentissage automatique peut également être placé sur un stockage plus volumineux

Mappage du volume d’apprentissage automatique d’Immich, avec le cache des modèles stocké sous un chemin /media plus volumineux dans ZimaOS
L’exemple de la communauté déplaçait le dossier du cache des modèles côté hôte, tout en conservant la destination de cache attendue par le conteneur.

L’onglet immich-server nécessite davantage de précautions

Mappages des volumes du serveur Immich montrant le chemin des téléversements et les dossiers multimédias sélectionnés redirigés vers un stockage sous /media
L’auteur de la publication d’origine a souligné que certains mappages d’immich-server devaient être modifiés, tandis que d’autres devaient rester exactement conformes aux attentes de l’application.

La publication d’origine avait été testée par la communauté et ne constituait pas une garantie d’IceWhale pour toutes les versions d’Immich. La pile Immich a considérablement évolué au fil du temps. Ne reproduisez donc pas exactement ce tableau de volumes de 2025 sur un paquet plus récent sans comparer la définition actuelle de l’application.

Les versions actuelles de ZimaOS proposent une procédure de stockage plus directe

Les instructions actuelles d’Immich pour ZimaOS permettent de modifier l’emplacement des fichiers de stockage et décrivent le déplacement des données d’Immich vers un autre disque au moyen de la migration des données ou d’une copie manuelle contrôlée.

Pour une installation actuelle, commencez par consulter les contrôles actuels de stockage et de migration d’Immich avant de recréer les mappages de volumes à partir d’une capture d’écran de 2025.

Si vous déplacez les fichiers manuellement, arrêtez d’abord Immich

Les recommandations actuelles de ZimaOS indiquent de désactiver Immich avant de copier manuellement ses données de galerie, puis de mettre à jour le chemin correspondant côté hôte et de redémarrer l’application. Interrompre les écritures pendant le déplacement réduit le risque de copier une photothèque incohérente.

FAQ sur le stockage d’Immich dans ZimaOS

Immich peut-il stocker les photos sur un disque plus volumineux au lieu de ZimaOS-HD ?

Oui. L’exemple de la communauté datant de 2025 et la procédure actuelle d’Immich dans ZimaOS permettent tous deux d’utiliser un autre emplacement de stockage.

Dois-je modifier le chemin PostgreSQL côté conteneur ?

Pas dans la procédure d’origine. Le chemin de stockage côté hôte était modifié, tandis que le chemin du conteneur d’application restait celui attendu par PostgreSQL.

Dois-je suivre exactement les quatre onglets de 2025 ?

Non. Considérez-les comme des exemples historiques de l’organisation des conteneurs. Comparez-les avec le paquet Immich actuel avant d’effectuer toute modification.

Existe-t-il désormais une option de migration intégrée ?

Les recommandations actuelles de ZimaOS pour Immich décrivent à la fois la migration des données et un déplacement manuel contrôlé des données d’Immich.