Skip to main content

7.1 - Préparer une mise à jour

Une mise à jour Immich peut inclure des changements de schéma PostgreSQL, d'images de conteneurs, de variables ou de montages. Un downgrade n'est pas pris en charge.

Avant toute mise à jour

  1. lire les notes de version depuis la version actuelle jusqu'à la cible ;
  2. relever la version du serveur et des clients mobiles ;
  3. vérifier l'état des conteneurs et de PostgreSQL ;
  4. déclencher un dump de base ;
  5. copier ou snapshotter les médias et la configuration ;
  6. vérifier l'espace libre ;
  7. attendre la fin des imports et tâches critiques ;
  8. prévoir une fenêtre de maintenance.

Inventaire

docker exec immich_server immich-admin version
docker compose images
docker compose ps
docker compose config --services
grep -E '^(IMMICH_VERSION|UPLOAD_LOCATION|DB_DATA_LOCATION)=' .env

TrueNAS :

sudo docker ps --format '{{.Names}} {{.Image}} {{.Status}}' | grep -i immich
sudo zfs list | grep -i immich
sudo zpool status

Sauvegarde de base

mkdir -p /srv/backups/immich
docker exec -t immich_postgres \
  pg_dump --clean --if-exists --dbname=immich --username=postgres \
  | gzip > /srv/backups/immich/pre-update.sql.gz

Adapter le conteneur, la base et l'utilisateur. Vérifier le fichier :

gzip -t /srv/backups/immich/pre-update.sql.gz
ls -lh /srv/backups/immich/pre-update.sql.gz

Snapshot

Sur TrueNAS, créer des snapshots manuels des datasets Immich après le dump. Le dump présent dans backups doit être inclus dans le snapshot ou copié avec les médias.

Compatibilité mobile

La documentation Immich indique que l'application mobile est généralement compatible avec la version majeure actuelle et précédente, tandis que le serveur attend la même version majeure. Mettre à jour les mobiles avant le serveur lors d'un passage majeur.

Critères de retour

Avant de commencer, décider ce qui impose un arrêt :

  • PostgreSQL ne démarre pas ;
  • migration de schéma en erreur ;
  • médias absents ;
  • authentification impossible ;
  • erreurs d'intégrité nouvelles ;
  • reverse proxy ou mobile inutilisable.

Le retour consiste à restaurer une sauvegarde et des fichiers cohérents, pas à simplement remettre une ancienne image sur une base déjà migrée.

Références :

  • https://docs.immich.app/install/upgrading/
  • https://docs.immich.app/administration/backup-and-restore/

No comments to display