Comment mettre manuellement à jour Immich sur ZimaOS

Si la version d’Immich affichée dans ZimaOS est antérieure à la version Immich disponible en amont et que l’App Store ne propose pas de bouton de mise à jour, il est possible de mettre à jour les conteneurs manuellement, mais la méthode correcte dépend du package Immich de ZimaOS que vous avez installé. Le fil de la communauté IceWhale de décembre 2025 a confirmé une simple modification de balise d’image pour le package Immich BigBear, tandis que des réponses ultérieures ont montré que cette astuce ne mettait pas systématiquement à jour les autres packages Immich.

La méthode communautaire consistait à ouvrir les paramètres de l’application et à modifier uniquement les immich-server et immich-machine-learning des balises d’image vers la version cible, en laissant les onglets de la base de données et de Redis inchangés. L’auteur du message original a confirmé que la mise à jour s’était déroulée sans problème, et un autre utilisateur de BigBear est ensuite passé avec succès de la v2.3.1 à la v2.4.1. Cependant, la documentation actuelle d’Immich exige que les administrateurs consultent les notes de version, sauvegardent la base de données et tiennent compte des modifications de Compose et de la base de données avant la mise à niveau. Les balises ne doivent donc pas être modifiées manuellement comme si cela constituait un bouton de mise à jour universellement « toujours sûr ».

Identifiez d’abord le package Immich que vous avez installé

Le fil contient au moins deux méthodes de déploiement :

• Immich BigBear : plusieurs utilisateurs ont indiqué que la modification des balises d’image dans ZimaOS avait déclenché la mise à jour avec succès.
• Package original/non-BigBear : un utilisateur a signalé plus tard être resté bloqué en v2.1.0, même après avoir essayé de modifier manuellement les versions du serveur et de l’apprentissage automatique.

Ouvrez les paramètres de l’application Immich dans ZimaOS et notez les noms d’image actuels, les balises, les mappages de volumes, l’image de la base de données et les variables d’environnement avant toute modification. Ne supposez pas que les instructions rédigées pour la définition BigBear correspondent à un autre modèle de l’App Store.

La mise à jour de la balise BigBear qui a fonctionné dans la communauté

La procédure communautaire qui a fonctionné était la suivante :

1. Sur le tableau de bord ZimaOS, ouvrez le menu à trois points de l’application Immich.
2. Sélectionnez Paramètres.
3. Ouvrez l’onglet immich-machine-learning.
4. Remplacez sa balise d’image par la version souhaitée d’Immich.
5. Ouvrez l’onglet immich-server.
6. Définissez-y la même balise de version.
7. Laissez les onglets de la base de données et de Redis inchangés, sauf si les notes de version exigent explicitement une modification de la base de données ou des conteneurs.
8. Enregistrez la configuration et laissez ZimaOS recréer ou récupérer les conteneurs concernés.

Au moment de la réponse originale, l’exemple de balise était le suivant :

v2.3.1

Cette version est historique. Un autre utilisateur a ensuite effectué une mise à jour vers v2.4.1, et une réponse d’avril 2026 mentionnait v2.7.4. Ne copiez aujourd’hui aucun de ces anciens numéros de version. Choisissez une version cible uniquement après avoir vérifié les notes de version actuelles d’Immich et votre procédure de mise à niveau.

Ce que l’auteur du message original a confirmé

Après avoir reçu les instructions concernant les balises BigBear, MikeFrizz a répondu que l’astuce était très utile et que la mise à jour s’était déroulée sans problème. Il s’agit du résultat confirmé le plus probant dans le fil source.

Cette confirmation étaye la méthode pour le paquet et le contexte de version utilisés par l’auteur de la publication initiale. Elle ne prouve pas que la modification manuelle de deux balises suffira pour chaque future version majeure d’Immich ni pour chaque paquet ZimaOS.

Ne supposez pas que la balise « latest » résoudra le problème

Un utilisateur a modifié la balise pour latest, mais ZimaOS revenait systématiquement à la version précédemment installée. La discussion contient ensuite des suppositions, comme essayer version, mais il n’existe aucune solution universelle confirmée par la source fondée sur ces noms de balises génériques.

La documentation actuelle d’Immich utilise une variable de version explicite et prend en charge les métabalises de version majeure dans son propre flux de travail Docker Compose. Pour une application ZimaOS empaquetée, utilisez le format de balise pris en charge par la définition du paquet et l’image en amont. Évitez d’inventer des balises simplement parce qu’un libellé semble plausible.

Sauvegardez Immich avant de changer de version

La documentation actuelle d’Immich recommande explicitement de sauvegarder la base de données avant les mises à niveau susceptibles d’impliquer des migrations. Vos photos et vidéos nécessitent également une stratégie de sauvegarde indépendante ; une sauvegarde de la base de données ne remplace pas la bibliothèque multimédia elle-même.

Utilisez le guide de sauvegarde et de restauration d’Immich avant tout changement manuel de version.

Au minimum, préservez :

• la sauvegarde de la base de données Immich ;
• la bibliothèque multimédia et les données téléversées ;
• la configuration actuelle de l’application ZimaOS et les mappages de volumes ;
• les balises d’image actuelles ;
• ainsi que toutes les variables d’environnement et les emplacements de stockage personnalisés.

Lisez les notes de version d’Immich avant chaque changement de version

La documentation actuelle de mise à niveau d’Immich indique que les administrateurs doivent consulter les notes de version pour vérifier les changements incompatibles avant toute mise à jour. La procédure Docker Compose standard en amont est la suivante :

docker compose pull && docker compose up -d

mais seulement après avoir adapté la définition Compose et les variables de version à la version cible.

Consultez le guide actuel de mise à niveau d’Immich.

Cela est important pour ZimaOS, car une application empaquetée peut être en retard non seulement au niveau des balises d’image, mais aussi au niveau de sa définition équivalente à Compose. Une version plus récente immich-server L’image peut nécessiter des modifications de la base de données, de l’environnement, des vérifications d’état ou des volumes, absentes d’un paquet plus ancien.

Maintenir la compatibilité entre les versions du serveur Immich et de l’apprentissage automatique

La communauté a spécifiquement modifié les balises pour les deux immich-server et immich-machine-learningLa documentation actuelle d’Immich avertit également que des divergences de version entre le serveur principal et les composants d’apprentissage automatique peuvent entraîner des bogues ou une instabilité.

Ne mettez pas à jour un seul des deux simplement parce qu’une image disponible est apparue en premier. Considérez-les comme une seule version d’application coordonnée, sauf si la documentation de la version actuelle indique explicitement le contraire.

Ne modifiez pas aléatoirement le tag du conteneur de base de données

Le conseil de la communauté consistant à laisser l’onglet de la base de données inchangé était pertinent pour les mises à jour mineures précises de BigBear évoquées. La couche PostgreSQL d’Immich possède ses propres migrations et a évolué au fil du temps, notamment avec la migration d’anciennes extensions vectorielles vers VectorChord.

• Ne mettez pas à niveau l’image de la base de données uniquement pour que tous les tags semblent numériquement similaires.
• Ne supposez pas que l’image de base de données ne doit jamais changer ; si les notes de version actuelles d’Immich exigent une migration de la base de données ou de Compose, suivez la procédure de migration documentée.

Que faire si l’application Immich d’origine de ZimaOS reste sur une ancienne version ?

Une réponse de mars 2026 indiquait que l’utilisateur n’exécutait pas la version de l’App Store BigBear et restait bloqué sur Immich v2.1.0, même après avoir tenté manuellement de mettre à jour les images machine-learning et serveur. Le fil ne contient aucune résolution confirmée pour le déploiement du paquet d’origine de cet utilisateur.

Il s’agit d’une limite importante : si la modification manuelle des tags d’image ne met pas l’application à jour, cessez de répéter la même opération. Comparez la définition actuelle des conteneurs du paquet avec les exigences Compose actuelles d’Immich et envisagez une migration vers un paquet ZimaOS maintenu uniquement après avoir effectué une sauvegarde et confirmé les chemins des données.

Ne désinstallez pas un paquet Immich fonctionnel avant de savoir où sont stockés ses volumes de base de données et de médias.

Pourquoi les utilisateurs de la communauté ont suggéré le paquet Immich de BigBear

La première réponse recommandait l’application Immich de BigBear, car elle était généralement maintenue plus près des versions en amont. Les instructions ultérieures permettant de modifier les tags avaient également été testées explicitement sur BigBear.

Cela ne fait pas de la « réinstallation de BigBear » une procédure de migration sûre en un clic pour une bibliothèque existante. Un paquet fraîchement installé peut utiliser des noms de volumes, des répertoires de données, des images de base de données ou des variables d’environnement différents. Considérez la migration du paquet comme une opération distincte de la mise à niveau d’une pile existante.

Soyez prudent avec les outils de mise à jour automatique des conteneurs

Une réponse de la communauté datant d’avril 2026 suggérait Tugtainer comme alternative plus simple à Watchtower pour vérifier et mettre automatiquement à jour les conteneurs. Cette suggestion peut être pratique pour les services sans état, mais Immich est une application d’état composée de plusieurs conteneurs, avec une base de données PostgreSQL et des procédures de mise à niveau documentées pour les changements incompatibles.

Pour Immich, le remplacement automatique des images sans consulter les notes de version peut être risqué. La documentation actuelle d’Immich indique explicitement aux administrateurs de tenir compte des changements incompatibles avant toute mise à niveau. Si vous utilisez malgré tout un outil de mise à jour automatique des conteneurs, privilégiez les notifications et l’approbation manuelle pour Immich plutôt qu’une mise à jour aveugle vers chaque nouveau tag.

Procédure de mise à jour Immich plus sûre sur ZimaOS

1. Notez si le paquet installé est BigBear ou une autre définition d’Immich.
2. Notez les images/tags actuels du serveur, du machine learning, de la base de données et de Redis.
3. Sauvegardez la base de données Immich et les médias importants.
4. Lisez les notes de version en amont pour chaque limite introduisant des changements incompatibles entre vos versions actuelle et cible.
5. Vérifiez si la version cible nécessite des modifications de Compose, de la base de données, des variables d’environnement ou du stockage.
6. Pour une mise à niveau mineure BigBear compatible, modifiez ensemble les balises du serveur et de l’apprentissage automatique, comme l’a fait la communauté.
7. Laissez les images de la base de données et de Redis inchangées, sauf si le chemin de mise à niveau documenté exige spécifiquement une modification.
8. Enregistrez les paramètres de l’application et surveillez les journaux des conteneurs pendant le démarrage des nouvelles images.
9. Vérifiez la version de l’interface Web d’Immich, les téléversements, les miniatures, l’apprentissage automatique et la bibliothèque existante avant de supprimer les anciennes images.
10. Si le package revient immédiatement en arrière ou reste sur l’ancienne version, examinez sa définition plutôt que de forcer les balises à répétition.

Points à vérifier après une mise à jour d’Immich

• L’interface Web se charge et indique la version de serveur prévue.
• L’application mobile peut se connecter et est compatible avec la version majeure du serveur.
• Les photos et vidéos existantes s’ouvrent correctement.
• Les nouveaux téléversements se terminent correctement.
• Les tâches de génération de miniatures et de transcodage s’exécutent.
• Les fonctionnalités d’apprentissage automatique démarrent sans erreurs d’incompatibilité de version.
• Le conteneur PostgreSQL reste en bonne santé.

La documentation actuelle d’Immich indique que la rétrogradation n’est pas une stratégie de récupération prise en charge. Une sauvegarde est plus sûre que de supposer que vous pourrez simplement rétablir la balise après une migration de base de données.

FAQ sur la mise à jour d’Immich dans ZimaOS

Puis-je mettre à jour Immich en modifiant les balises d’image de ZimaOS ?

Oui, pour certaines combinaisons de packages et de versions. L’auteur de la publication initiale et un autre utilisateur de BigBear ont confirmé que la modification des balises du serveur et de l’apprentissage automatique avait fonctionné. Le fil contient également un utilisateur qui n’utilisait pas BigBear et pour qui cette méthode n’a pas résolu le problème de l’installation obsolète.

Quelles balises Immich dois-je modifier ?

Dans la méthode BigBear communautaire confirmée, les immich-server et immich-machine-learning les balises ont été modifiées ensemble. Ne copiez pas les anciens exemples v2.3.1, v2.4.1 ou v2.7.4 comme versions cibles actuelles.

Dois-je utiliser latest ?

Pas comme solution universelle. Un utilisateur du fil a indiqué que latest n’a pas fonctionné. Utilisez le schéma de version pris en charge par votre package réel et les recommandations actuelles d’Immich.

Puis-je simplement exécuter docker pull ?

Télécharger une nouvelle image ne recrée pas à lui seul le conteneur en cours d’exécution et n’applique pas les modifications de Compose. Immich en amont utilise docker compose pull && docker compose up -d après avoir préparé la configuration pour la version cible.

Tugtainer ou Watchtower doivent-ils mettre Immich à jour automatiquement ?

Les mises à jour automatiques peuvent ignorer l’examen des notes de version et des migrations, qu’Immich recommande explicitement. Pour une application avec état et base de données, une notification et des mises à niveau manuelles et contrôlées sont plus sûres qu’un remplacement automatique à l’aveugle.

Ai-je besoin d’une sauvegarde avant une mise à jour d’Immich ?

Oui. La documentation actuelle d’Immich sur les mises à niveau et les sauvegardes recommande de protéger la base de données avant toute mise à niveau, et vous devez également protéger séparément les fichiers multimédias irremplaçables.