7.2 - Mettre à jour Docker Compose

Mise à jour standard

Depuis le dossier Compose :

cd /srv/immich/app
docker compose pull
docker compose up -d

Suivre :

docker compose ps
docker compose logs -f immich-server

Les migrations de base peuvent prendre du temps. Ne pas interrompre un traitement simplement parce que le journal reste plusieurs minutes sur une réindexation.

Mettre à jour les fichiers Compose

Lors d'une version majeure, comparer le fichier local au fichier officiel :

wget -O /tmp/immich-compose-nouveau.yml \
  https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml

diff -u docker-compose.yml /tmp/immich-compose-nouveau.yml

Ne pas remplacer aveuglément un fichier contenant des montages GPU, bibliothèques externes ou réseaux personnalisés. Reporter les adaptations sur la nouvelle base officielle.

Télécharger aussi l'exemple d'environnement :

wget -O /tmp/immich-env-nouveau \
  https://github.com/immich-app/immich/releases/latest/download/example.env

diff -u .env.example /tmp/immich-env-nouveau

Ne pas comparer ou partager un .env réel contenant des secrets.

Passage de v2.7.5 vers v3

Procédure recommandée :

1. sauvegarder complètement v2.7.5 ;
2. restaurer ou valider la copie sur v2.7.5 si une migration d'hôte est en cours ;
3. mettre les applications mobiles à jour ;
4. lire les notes de rupture v3 ;
5. adapter Compose et les variables ;
6. passer IMMICH_VERSION à v3 ;
7. lancer docker compose pull && docker compose up -d ;
8. vérifier schéma, comptes, albums, OAuth et médias.

Vérifications après mise à jour

docker exec immich_server immich-admin version
docker exec immich_server immich-admin schema-check
docker compose ps
docker compose logs --tail=200

Puis tester interface, mobile, upload, lecture vidéo, recherche, visages, bibliothèque externe et dump PostgreSQL.

Nettoyage différé

Après plusieurs jours de validation :

docker image prune

Conserver les sauvegardes pré-mise à jour selon la politique de rétention.

Référence : https://docs.immich.app/install/upgrading/