Immich passe en v3 : voici comment mettre à jour votre NAS

Je vous avais présenté l’installation complète d’Immich sur un NAS Synology il y a quelques semaines, avec Container Manager. Depuis, l’équipe de développement n’est pas restée inactive. Après plusieurs mois de travail, Immich vient de franchir un cap important avec la sortie de la version 3.0. Il s’agit d’une mise à jour majeure, avec son lot de nouveautés côté mobile et Web, mais aussi quelques changements de fond qu’il vaut mieux connaître avant de vous lancer…

immich synology v3 - Immich passe en v3 : voici comment mettre à jour votre NAS

Qu’est-ce qu’Immich ?

Pour ceux qui découvre Immich, il s’agit d’un logiciel open source de gestion et sauvegarde de photos et vidéos, à héberger sur votre NAS. C’est l’alternative la plus aboutie à Google Photos pour qui veut garder la main sur ses souvenirs : sauvegarde automatique depuis le mobile, reconnaissance faciale et d’objets en local, recherche avancée, vue carte, partage simplifié… le tout sans dépendre d’un GAFAM ni d’un abonnement. Si vous voulez tous les détails, direction mon article d’installation.

Quoi de neuf avec la v3

Cette version 3.0.0 embarque plusieurs changements majeurs, principalement liés à l’API et qui concernent avant tout les outils tiers qui s’y connectent. Pour la grande majorité des utilisateurs, la mise à jour se déroule très simplement. Un point technique important : le support de pgvecto.rs est définitivement abandonné. Si vous utilisez encore une installation ancienne (avant v1.133.0) et que vous n’avez jamais migré vers VectorChord, il faudra le faire avant de passer en v3 (guide de migration officiel).

Côté nouveautés, voici ce qu’il faut retenir :

  • Édition non destructive sur mobile : l’éditeur photo dans l’App reprend le même moteur que la version web (recadrage, rotation, ajustements), avec des modifications réversibles. Quelques fonctions de l’ancien éditeur (recoloration, retouche des Live Photos) disparaissent, en attendant leur retour dans une future version.
  • Workflows (aperçu) : vous pouvez enchaîner des déclencheurs, des filtres et des actions dans un éditeur visuel ou en JSON, accessible depuis Utilitaires > Workflows (en préversion) pour automatiser le tri ou le classement de votre bibliothèque.
  • Sauvegarde en arrière-plan améliorée : sur Android, la sauvegarde automatique repose désormais sur un nouveau planificateur de tâches périodiques, capable de couvrir toute votre bibliothèque (et plus seulement les nouvelles photos), avec de meilleurs réglages liés à l’optimisation batterie. Sur iOS, la synchronisation et l’envoi s’exécutent en parallèle pour mieux tenir dans les fenêtres d’exécution imposées par le système.
  • Page « Récemment ajoutés » : une nouvelle vue trie votre bibliothèque selon la date d’import (et non la date de prise de vue), très pratique après un gros import.
  • Contrôles d’intégrité : la page de maintenance embarque désormais une vérification qui compare les fichiers sur le disque à ce qu’il y a en base de données Immich, avec remontée des fichiers non suivis, manquants ou dont la somme de contrôle ne correspond plus.
  • Diaporama sur mobile : comme ce qui existait déjà sur le web.
  • Transcodage vidéo HLS en temps réel (aperçu) : Immich peut désormais transcoder vos vidéos à la volée, sans passer par une génération hors ligne (en préversion), pour l’instant sur le Web uniquement (accélération matérielle nécessaire).
  • Nouveau lecteur vidéo pour le web : avec des contrôles cohérents sur tous les appareils.
  • Immich comme visionneuse sur Android : vous pouvez désormais ouvrir directement une photo ou vidéo depuis une autre application avec Immich.
  • OCR sur mobile : pour repérer et copier le texte présent dans une image.
  • Envoi direct : vers un album et choix de la taille d’image au partage sur mobile.
  • Amélioration des performances : de la timeline, pour fluidifier la navigation dans les mois comportant énormément de photos…

La liste complète (très longue) des correctifs et améliorations est disponible sur la page GitHub.

Mettre à jour Immich v3 sur votre NAS Synology

Rien de compliquer… On va changer simplement le tag de version dans le fichier docker-compose.yml de l’installation initiale. Pour rappel, si votre installation actuelle fonctionne bien, il n’y a jamais d’urgence à mettre à jour immédiatement une version majeure : prenez le temps de lire les changements si vous utilisez des intégrations tierces avec l’API.

Modifier le fichier compose.yaml

Ouvrez Container Manager, allez dans Projet, sélectionnez Immich et cliquer sur le bouton Arrêter en haut à droite.

Immich v3 update - Immich passe en v3 : voici comment mettre à jour votre NAS

Allez sur l’onglet Configuration YAML et repéré les deux services concernés, immich-server et immich-machine-learning, et changez le tag :v2 en :v3 :

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:v3   # anciennement :v2
    ...

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:v3   # anciennement :v2
    ...

Les services redis et database (PostgreSQL) n’ont pas besoin d’être modifiés pour cette mise à jour. Cliquez sur le bouton Sauvegarder en bas à droite et laisser le choix par défaut (voir image ci-dessous).

Creer demarrer le projet - Immich passe en v3 : voici comment mettre à jour votre NAS

Une fois que vous avez cliquez sur OK, il ne reste plus qu’à patienter… Container Manager va alors télécharger les nouvelles images v3 et redémarrer l’ensemble des conteneurs. Cliquer une dernière fois sur Fermer. C’est terminé !

En synthèse

Immich v3 est une mise à jour majeure. La procédure de mise à jour reste identique à d’habitude (changement de tag d’image, nettoyage, recréation du projet) et les changements touchent avant tout l’API pour les intégrations tierces. Côté utilisateur, on retiendra surtout l’arrivée de l’édition non destructive sur mobile, la première mouture des Workflows qui ouvre la voie à de belles automatisations, une sauvegarde en arrière-plan Android bien plus fiable et les contrôles d’intégrité qui viennent renforcer la confiance qu’on peut avoir dans sa bibliothèque auto-hébergée.

Si votre installation tourne déjà bien en v2, rien ne presse… mais si vous avez l’habitude de suivre les nouveautés, cette v3 vaut clairement le détour.

  1. Sinon, il y a Amish ! Gestions des photos dans un bel album papier décoré à la main et photo argentique développé chez le photographe ^^

      1. Rien de constructif à votre commentaire désolant… contrairement au commentaire auquel vous répondez qui lui au moins était drôle 🙂

        Bien joué la team 1er degré !

        1. T’inquiète Flop, je ne donne plus à manger aux trolls.
          Cette boutade était pour attirer l’attention sur le nom de cette appli qui est bien étrange au vu de ce qu’elle propose.

  2. Un grand merci à toi !
    Je suis, pour je ne sais quelle raison, un pro-mise-a-jout ce qui de temps en temps me joue des tours !
    Hier encore, mise à jour et bim… le conteneur du serveur Immich crash et redémarre en boucle.

    J’utilisais depuis le début ton docker_compose.yml du premier tuto.

    Je me réveille, regarde les news, et je tombe sur ton article !!! Merci bien !

  3. Hello à tous, au cas ou cela puisse aider quelqu’un qui était en v2 et est passé en V3. pour le conteneur qui redémarre en boucle, il suffit en fait de mettre à jour le SQL en remplaçant l’image dans le YAML.

    moi j’avais :
    image: tensorchord/pgvecto-rs:pg16-v0.2.1
    que j’ai remplacé par :
    image: ghcr.io/immich-app/postgres:16-vectorchord0.3.0-pgvectors0.3.0

  4. Ce tutoriel comporte une erreur critique sur les tags Docker d’Immich. L’équipe d’Immich n’utilise pas de tags majeurs génériques comme :v2 ou :v3 pour leurs images officielles sur GitHub Container Registry (ghcr.io).

    En remplaçant le tag par :v3, Container Manager n’a pas pu télécharger l’image (l’image ghcr.io/immich-app/immich-server:v3 n’existe pas), ce qui empêche le conteneur de démarrer.
    Résolution du problème

    La solution officielle et recommandée par les développeurs d’Immich pour toujours bénéficier des mises à jour (y compris la version 3.0) sans casser votre projet consiste à utiliser le tag :release.

    llez dans l’onglet Configuration YAML (ou modifiez le fichier directement) et remplacez :v3 par :release pour les deux services :
    YAML

    services:
    immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:release
    …

    immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:release
    …

    1. Bonjour Adrien,

      Merci pour ton message, mais il n’y a aucune erreur critique ici. Nous sommes nombreux à avoir utilisé la balise :v3 qui provient de la documentation officielle dans la rubrique migration https://docs.immich.app/install/upgrading/... (lien présent également dans l’article ci-dessus). Je cite : « You can configure your Docker image to point to the current major version by using a metatag, such as :v3. These metatags do not follow release candidates ». Dans la langue de Molière, cela donne : « Vous pouvez configurer votre image Docker pour qu’elle fasse référence à la version majeure actuelle à l’aide d’une balise méta, telle que :v3. Ces balises méta ne prennent pas en compte les versions candidates ».

      :v3 n’est pas un tag figé, c’est ce que l’on appelle un tag « flottant » qui suit la dernière version 3.x. Il suit automatiquement les dernières mises à jour mineures/patchs (v3.0.0 -> v3.1.0 -> v3.2.0 → v3.2.2…) sans jamais basculer vers v4 tout seul. Cela permet de rester dans une version, sans saut d’une version majeure. C’est un fonctionnement standard dans de nombreux projets avec docker.

      :release fonctionne également, tu as raison de l’indiquer. Cependant, il comporte un risque majeur de mon point de vue. Il prend toujours la toute dernière version, toutes majeures confondues. Au passage v2 -> v3, avec le tag release toutes les installations ont planté lors de la mise à jour. En effet, la v3 introduisait de nombreux breaking changes. C’est pour cette raison que je ne recommande pas ce choix. Mais libre à toi de faire comme tu le souhaites.

      Je préfère jouer la sécurité et proposer de rester dans une release stable dans une version… et proposer un tutoriel pour faire un changement en douceur par exemple lorsque la v4 sortira.

      Je confirme donc que mettre image: ghcr.io/immich-app/immich-server:v3 fonctionne bien. Tu ne seras pas en version 3 (qui n’existe pas) ou 3.0.0 mais à la date du jour (19/09) en v3.2.2, soit la dernière version stable disponible dans la branche majeur 3.

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. Découvrez comment les données de vos commentaires sont traitées.