Si Immich sur ZimaOS reste sur une ancienne version après que vous avez modifié uniquement la balise d’image immich-server, cessez de modifier un conteneur à la fois et commencez par identifier le paquet ou la pile. Immich est une application composée de plusieurs services ; le serveur, l’apprentissage automatique, la base de données et les composants de cache doivent rester compatibles, et certains paquets ZimaOS sont gérés par différentes sources de l’App Store.
Le fil source montre pourquoi une mise à jour d’un seul champ peut échouer : l’utilisateur a modifié l’image du serveur, constaté une activité de téléchargement réseau, redémarré, puis Immich indiquait toujours la version 2.6.1. Un autre utilisateur a montré une configuration fonctionnelle en v3.1.0 avec des images de service correspondantes. Le guide correct est donc « sauvegarder, identifier la pile, mettre à jour de manière cohérente, vérifier », et non « saisir un numéro plus récent dans un seul champ ».
Étape 1 : Identifier le paquet Immich que vous avez installé
ZimaOS peut proposer des paquets officiels ainsi que des paquets provenant de boutiques tierces ou communautaires. Ouvrez les paramètres de l’application et notez l’image de chaque service, pas seulement immich-server.
Notez également la source de l’App Store afin de savoir qui contrôle les métadonnées de mise à jour.
Étape 2 : Sauvegarder Immich avant toute mise à jour majeure
Sauvegardez la photothèque et la base de données PostgreSQL. L’guide actuel de sauvegarde et de restauration d’Immich décrit une procédure d’export de la base de données.
Ne considérez pas la recréation d’un conteneur comme une sauvegarde.
Étape 3 : Vérifier les versions de tous les services
La comparaison des sources indiquait :
- Serveur Immich ;
- Apprentissage automatique d’Immich ;
- Postgres ;
- Valkey/Redis.
Notez les balises d’image complètes. Si l’App Store les gère comme un ensemble testé, privilégiez son action de mise à jour plutôt que de mettre manuellement un composant à jour avant les autres.
Étape 4 : Utiliser la mise à jour de l’App Store lorsqu’elle est disponible
La documentation actuelle de ZimaOS indique que la dernière version du paquet Immich peut être installée depuis l’App Store. Si un bouton de mise à jour est disponible, utilisez-le afin que la définition Compose du mainteneur du paquet soit également mise à jour.
Le guide Immich de ZimaOS actuel constitue le point de départ officiel recommandé pour ZimaOS.
Pourquoi la modification d’une seule balise peut sembler lancer un téléchargement sans effectuer la mise à jour
Le gestionnaire d’applications peut télécharger une nouvelle image, mais recréer le service à partir des métadonnées de la boutique, d’une autre valeur YAML enregistrée ou d’une définition d’image différente. Le conteneur en cours d’exécution peut donc revenir à l’ancienne balise.
Vérifiez l’image réellement utilisée avec :
docker ps --format '{.Names} {.Image}'Ne franchissez pas aveuglément plusieurs versions majeures d’Immich
Les versions d’Immich peuvent inclure des modifications de la base de données, du schéma et des services. Consultez les notes de version et de mise à niveau en amont pour les versions concernées. Mettez à jour la pile dans son ensemble plutôt que de deviner des combinaisons compatibles.
Si vous utilisez un paquet BigBear ou un autre paquet tiers
Un guide distinct de la communauté ZimaSpace indique que la modification des balises d’image a fonctionné pour certains paquets BigBear, tandis que des utilisateurs ultérieurs ont constaté que la même astuce n’était pas universelle pour tous les paquets. Identifiez la source du paquet avant d’appliquer cette solution de contournement.
Le guide de mise à jour d’Immich explique cette limite propre aux paquets.
Vérifiez la mise à jour après avoir recréé la pile
Vérifiez trois emplacements :
- les balises des images Docker utilisées ;
- l’affichage de la version du serveur par Immich ;
- les journaux du conteneur pour rechercher des erreurs de migration ou de compatibilité.
Ne supprimez pas la base de données ni le dossier d’importation pour forcer une mise à jour
La suppression des volumes constitue une réinitialisation destructive, et non une méthode de mise à jour. Préservez la base de données et la photothèque, sauf si vous disposez d’une sauvegarde testée et souhaitez intentionnellement effectuer une nouvelle installation.
FAQ
Pourquoi Immich affiche-t-il toujours 2.6.1 après la modification de la balise du serveur ?
L’application recrée peut-être l’ancienne définition de service, ou la pile n’a peut-être pas été mise à jour de manière cohérente. Vérifiez l’image réellement utilisée et la source du paquet.
Le service de machine learning doit-il correspondre exactement à la version du serveur ?
Suivez les versions testées dans la définition de version/Compose d’Immich que vous déployez. N’inventez pas de balises indépendantes pour chaque service.
Puis-je mettre à jour uniquement immich-server ?
Évitez d’en faire la méthode par défaut. Immich est une pile de services multiples, et les mises à niveau peuvent nécessiter des modifications coordonnées.
Que dois-je sauvegarder en premier ?
La base de données PostgreSQL et votre espace de stockage multimédia/importations. Vérifiez la sauvegarde avant toute modification de version majeure.
