Évitez la perte de configuration d’Immich pendant les mises à niveau en traitant le fichier Compose, les valeurs d’environnement, la base de données, la bibliothèque de téléversements et les définitions de montage des bibliothèques externes comme des éléments persistants distincts qui doivent être sauvegardés et restaurés ensemble.
Un conteneur est remplaçable ; la configuration qui l’entoure ne l’est pas. Une mise à niveau peut donner l’impression d’effacer Immich si un montage lié relatif est résolu à partir d’un autre répertoire de projet, si une modification de l’environnement n’est jamais appliquée au conteneur recréé ou si la nouvelle pile démarre sur une base de données vide. Inventoriez d’abord le déploiement actif, conservez des copies versionnées hors de l’hôte et testez une recréation contrôlée avant la mise en production.
Capturez le déploiement actif avant chaque mise à niveau
Exportez la configuration Compose effective en masquant les secrets, consignez les versions ou les condensats des images et copiez les fichiers Compose et d’environnement dans un stockage avec gestion des versions. Vérifiez les montages en cours d’exécution au lieu de supposer que le fichier ouvert dans votre éditeur a lancé les conteneurs actuels. La vérification réussit lorsque chaque chemin d’exécution correspond à un emplacement hôte connu.
Consignez les chemins des bibliothèques externes, les paramètres du proxy inverse, l’URL du machine learning, les valeurs de connexion à la base de données, l’identité de l’utilisateur et du groupe, les noms de réseau ainsi que les périphériques d’accélération matérielle. Tout élément manquant ici deviendra plus tard une différence inexpliquée après la mise à niveau.
Les questions récurrentes de la communauté sur les mises à niveau montrent que les opérateurs perdent souvent de vue la génération de Compose ou la disposition des fichiers d’environnement qui s’applique. La leçon utile tirée d’une discussion sur la configuration de la mise à niveau est de préserver la définition actuelle fonctionnelle avant de la traduire.
Sauvegardez séparément la base de données, les médias et les fichiers de déploiement
Effectuez une sauvegarde native de la base de données ainsi qu’une sauvegarde ou un instantané du système de fichiers de la bibliothèque de téléversements et du répertoire de déploiement. Consignez les heures de début et de fin, les tailles des archives et les sommes de contrôle. Une sauvegarde contenant uniquement le fichier YAML Compose permet de reconstruire les conteneurs, mais pas de restaurer les comptes, les métadonnées, les albums ni les enregistrements des ressources.
Utilisez une sauvegarde à l’arrêt pour définir la limite de cohérence la plus simple, ou coordonnez un export à chaud de la base de données et un instantané du stockage afin que leur relation soit documentée. Gardez les bibliothèques externes dans l’inventaire même si Immich ne possède pas leurs originaux, car les chemins et les règles d’accès ont tout de même une incidence sur le service restauré.
Une procédure de mise à niveau entre versions majeures maintenue par la communauté insiste sur la préservation de la base de données, des médias, de Compose et des paramètres d’environnement. Considérez son enchaînement comme un retour d’expérience opérationnel et vérifiez chaque étape en fonction de la version que vous déployez réellement.
Préparer la mise à niveau avec des versions figées
Lisez les notes de version de chaque version intermédiaire ignorée et mettez à jour délibérément la définition du déploiement enregistrée. Fixez la version cible, téléchargez-la sans supprimer les anciennes images, puis validez la configuration Compose générée. Variables inconnues, montages vides ou versions de services mélangées : la validation de préproduction échoue.
Si la capacité le permet, restaurez la sauvegarde sur une pile de test isolée, avec des ports différents et sans accès en écriture à la production. Démarrez-la sur la version cible et inspectez les migrations, les utilisateurs, les chemins de stockage et les tâches en arrière-plan. Le simple démarrage réussi d’un conteneur ne prouve pas que la bibliothèque d’origine est rattachée.
Le guide connexe de ZimaSpace sur un NAS autohébergé sécurisé aide à placer les fichiers de déploiement et les sauvegardes hors des limites de l’hôte et des identifiants uniques qu’une mise à niveau peut perturber.
Vérifier la persistance de la configuration après recréation
Avant la bascule, recréez les conteneurs de test à partir des fichiers enregistrés au lieu de les redémarrer tels quels. Vérifiez les utilisateurs, les paramètres du serveur, les modèles de stockage, les bibliothèques, les tâches, l’accès via le proxy et les valeurs effectives de l’environnement. La configuration est validée si elle résiste au remplacement, car elle réside dans des composants persistants documentés.
Après la bascule en production, téléversez une ressource de test, lancez une recherche, ouvrez un original et créez une nouvelle sauvegarde de la base de données. Redémarrez la pile et l’hôte, puis recommencez. Conservez l’ancienne version, la sauvegarde et la définition du déploiement jusqu’à ce que la charge de travail normale soit restée stable pendant toute la période d’observation.
Si la mise à niveau a déjà démarré sans données, arrêtez-la avant que l’intégration ou de nouveaux téléversements ne créent un état incohérent. Ne rattachez qu’un chemin persistant vérifié ou restaurez les données dans une cible vierge. Revenez à la version précédente si des utilisateurs ou des ressources attendus sont absents ; si l’identité reste incertaine, transmettez la configuration Compose effective, les montages, les versions et les horodatages des sauvegardes, après avoir supprimé les informations sensibles.
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,...



