# 7.2 - Mettre à jour Docker Compose

## Mise à jour standard

Depuis le dossier Compose :

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

Suivre :

```bash
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 :

```bash
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 :

```bash
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

```bash
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 :

```bash
docker image prune
```

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

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