10.1 - Restauration par l'interface et l'onboarding

Les versions récentes d'Immich permettent de restaurer un dump depuis l'interface. Cette méthode est recommandée pour la plupart des utilisateurs.

Instance existante

1. ouvrir Administration > Maintenance ;
2. ouvrir la section de restauration de base ;
3. choisir un dump disponible ;
4. vérifier sa version ;
5. confirmer la restauration ;
6. attendre le contrôle de santé ;
7. examiner les journaux et l'intégrité.

Immich crée un point de restauration de la base actuelle avant l'opération et tente un retour automatique si la restauration échoue.

Nouvelle instance avec onboarding

Avant le premier démarrage, replacer les dossiers de l'ancienne instance dans le nouvel UPLOAD_LOCATION :

backups
encoded-video
library
profile
thumbs
upload

Configurer également les bibliothèques externes avec les mêmes chemins internes.

Démarrer Immich, puis :

1. cliquer sur Restore from backup ;
2. examiner les contrôles de lecture et d'écriture ;
3. sélectionner un dump présent dans backups ;
4. ou envoyer un fichier .sql.gz ;
5. confirmer ;
6. attendre les migrations et le contrôle de santé.

Compatibilité

Immich affiche un indicateur de compatibilité de version. Restaurer de préférence un dump produit par une version identique ou compatible.

Pour une source v2.7.5 et une cible v3, conserver une copie complète avant la migration. Si le diagnostic devient difficile, restaurer d'abord dans une instance v2.7.5 isolée, puis effectuer la montée de version.

Après restauration

• contrôler les comptes ;
• ouvrir plusieurs originaux ;
• vérifier albums, favoris et partages ;
• examiner Administration > Maintenance ;
• lancer les tâches manquantes ;
• vérifier les bibliothèques externes ;
• tester OAuth et mobile ;
• créer un nouveau dump.

Ne pas confondre

La restauration de la base ne restaure pas les photos. Les fichiers doivent déjà être présents et cohérents avec les chemins du dump.

Référence : https://docs.immich.app/administration/backup-and-restore/