La solution de contournement décrite dans la source était pratique pour un paquet Immich de 2025, mais elle ne devrait pas être figée dans un tutoriel de mise à jour actuel. Un utilisateur de la communauté a modifié manuellement la immich-server et immich-machine-learning les balises d’image vers v1.134.0. L’auteur du message original a indiqué que cela avait finalement fonctionné sur son système ZimaOS principal, mais pas sur une machine virtuelle de test.
Immich est depuis passé à v3 et son modèle de déploiement maintenu utilise une pile Docker Compose complète ainsi qu’une valeur IMMICH_VERSION. La mise à jour d’une ou deux balises de service seulement peut créer une pile utilisant des versions différentes lorsque les hypothèses concernant la base de données, le cache, le machine learning ou l’API ont changé.
La source de 2025 a modifié individuellement les balises des services Immich
La communauté a conseillé à l’utilisateur de modifier le serveur et le machine learning
CogZog a indiqué les deux immich-server et immich-machine-learning devrait utiliser la nouvelle balise. L’utilisateur a confirmé avoir modifié les deux, mais la machine virtuelle de test est tout de même restée sur l’ancienne version.
La version de ZimaOS principale a finalement atteint la version v1.134.0
La source n’a pas établi de règle imposant de mettre à jour manuellement l’image de la base de données
beep a demandé si la base de données devait également être migrée vers une balise plus récente et stable. La réponse de la communauté était essentiellement : « si ce n’est pas cassé, ne le réparez pas ». Il s’agissait d’une opinion, pas d’une politique de migration d’Immich.
La version actuelle d’Immich est v3, avec une procédure complète de mise à jour de Compose
Immich v3.0.0 est sorti en juillet 2026. L’amont indique de mettre à jour la pile maintenue en définissant IMMICH_VERSION=v3 et d'exécuter le processus normal de récupération et de recréation avec Compose, tout en consultant également les notes relatives aux changements incompatibles et à la migration de la version 3.
Consultez les recommandations actuelles concernant la version 3 d'Immich.
La recommandation actuelle en amont est d'utiliser le bundle Docker Compose complet
La documentation d'installation actuelle d'Immich indique aux utilisateurs de télécharger la version docker-compose.yml et .env, puis définissez les emplacements et IMMICH_VERSION. Le chemin de la base de données PostgreSQL doit rester sur un système de fichiers local pris en charge plutôt que sur un partage réseau.
Utilisez le modèle Compose actuel d'Immich pour les déploiements manuels ou personnalisés.
Pour le paquet de l'App Store ZimaOS, privilégier le processus actuel de mise à jour des applications
L'App Store ZimaOS 2.0 actuel inclut la gestion des mises à jour des applications installées. Si le paquet de la boutique propose une mise à jour d'Immich, laissez la définition du paquet mettre à jour l'ensemble de la pile multiservice au lieu de modifier indépendamment la balise d'un seul service.
Sauvegarder avant une mise à niveau majeure d'Immich
Protégez à la fois la photothèque/vidéothèque et l'état de la base de données et de l'application avant une modification majeure de version. Un répertoire de bibliothèque sain ne suffit pas à lui seul à reconstruire les albums, les utilisateurs, les métadonnées et l'état de l'application.
Éviter de créer une pile Immich composée de versions mixtes
Immich n'est pas un conteneur indépendant. L'application, le service d'apprentissage automatique, la base de données et les autres composants de support sont testés comme une topologie de publication coordonnée. La mise à jour d'une image tandis qu'une autre reste épinglée peut entraîner des incompatibilités d'API, de schéma ou de démarrage.
Le fonctionnement de la source n'a été possible qu'après que la pile effective de l'utilisateur a été suffisamment alignée pour exécuter la v1.134.0 ; cela ne prouve pas que le mélange arbitraire de balises soit sûr.
Conserver PostgreSQL sur un stockage local pris en charge
Les exigences actuelles d’Immich indiquent que le répertoire de données PostgreSQL doit utiliser un système de fichiers local et ne doit pas se trouver sur un partage réseau. L’état de la base de données est généralement peu volumineux par rapport à la photothèque, mais il est essentiel pour les utilisateurs, les albums, les métadonnées et l’état de l’application.
Sachez si vous avez installé le paquet ZimaOS ou une pile Compose personnalisée
Si Immich provient de l’App Store de ZimaOS, utilisez le processus de mise à jour actuel de la boutique et examinez les modifications apportées au paquet. Si vous avez importé votre propre Compose, vous êtes responsable du verrouillage de la version en amont, .env, le chemin de la base de données et les étapes de migration.
Mélanger les modifications de l’App Store avec une pile en amont gérée manuellement complique les futurs dépannages.
Effectuez les vérifications préalables à une mise à niveau majeure
- Confirmez qu’une sauvegarde récente de la photothèque existe.
- Sauvegardez l’état de la base de données et de l’application.
- Notez la version actuelle et les mappages de volumes.
- Lisez les notes en amont relatives aux changements incompatibles.
- Assurez-vous que le disque système/AppData dispose de suffisamment d’espace libre pour les téléchargements d’images et les migrations.
Vérifiez la version en cours d’exécution et les tâches après la mise à jour
Ne vous arrêtez pas à « Enregistrement terminé ». Ouvrez la page À propos/Système d’Immich, confirmez la version du serveur en cours d’exécution, vérifiez l’état de santé des conteneurs, puis contrôlez les téléversements, les miniatures, les tâches d’apprentissage automatique et la connectivité de l’application mobile.
La source elle-même le montre : modifier la balise ne signifiait pas immédiatement que l’instance en cours d’exécution avait réellement été mise à jour.
La restauration ne consiste pas toujours simplement à rétablir l’ancienne balise
Une fois qu’une version majeure a migré le schéma ou l’état de la base de données, la rétrogradation d’une image peut ne pas être prise en charge. Suivez les indications de migration et de restauration en amont, et utilisez des sauvegardes plutôt que de supposer qu’une balise précédente constitue un bouton universel d’annulation.
FAQ sur les mises à jour d’Immich
La méthode manuelle de balisage de 2025 a-t-elle fonctionné sur le système principal de l’utilisateur source ?
Oui, à terme. Leur machine virtuelle de test ne s’est pas comportée de la même manière.
Les utilisateurs actuels d’Immich doivent-ils mettre à jour uniquement les balises immich-server et machine-learning ?
Non. Immich v3 est actuellement maintenu sous la forme d’une pile Compose complète, avec des indications sur les versions et les migrations.
IceWhale a-t-il promis des mises à jour automatisées d’Immich dans la source ?
Non. Zima-Giorgio a seulement dit que l’équipe discuterait de la demande.
