Immich Installation, administration, migration et sauvegarde
Guide complet pour installer, exploiter, sécuriser, sauvegarder, migrer, restaurer et dépanner Immich avec Docker Compose ou TrueNAS.
1 - Présentation et architecture
Comprendre Immich, ses composants, ses besoins et les données à protéger.
1.1 - Rôle, fonctions et limites d'Immich
Immich est une plateforme auto-hébergée destinée à sauvegarder, parcourir, rechercher et partager...
1.2 - Architecture et services
Une installation Immich standard repose sur plusieurs services. Le nom exact des conteneurs varie...
1.3 - Prérequis et dimensionnement
Configuration minimale et recommandée La documentation Immich indique actuellement : Ressource Mi...
1.4 - Données critiques et arborescence
Immich utilise six dossiers principaux dans son emplacement de médias, généralement monté dans le...
2 - Installation avec Docker Compose
Déployer Immich sur un serveur Linux avec la méthode recommandée Docker Compose.
2.1 - Préparer Linux et Docker
Docker Compose est la méthode recommandée par Immich pour un déploiement Linux standard. Préparer...
2.2 - Télécharger Compose et configurer .env
Télécharger les fichiers officiels cd /srv/immich/app wget -O docker-compose.yml \ https://gith...
2.3 - Démarrer et contrôler les conteneurs
Démarrer Immich Depuis le dossier contenant .env et docker-compose.yml : cd /srv/immich/app doc...
2.4 - Première connexion et configuration initiale
Créer le compte administrateur Le premier compte enregistré devient administrateur. Accéder à l'i...
3 - Installation sur TrueNAS
Préparer les datasets, permissions, ressources et stockages de l'application Immich sur TrueNAS.
3.1 - Concevoir les datasets Immich
Organisation recommandée Pour TrueNAS Community Edition, Immich utilise au minimum deux zones de ...
3.2 - Installer et configurer l'application
Installer l'application Ouvrir Apps. Cliquer sur Discover Apps. Rechercher Immich. Ouvrir l'ap...
3.3 - Permissions, UID, GID et ACL
Les erreurs de permissions empêchent souvent Immich ou PostgreSQL de démarrer. Identifier les UID...
3.4 - Stockages multiples et bibliothèques externes
Stockages Immich séparés Pour chaque dataset supplémentaire, ajouter une entrée Additional Stora...
4 - Configuration et utilisation quotidienne
Configurer les utilisateurs, les modèles de stockage, la sauvegarde mobile, les bibliothèques et ...
4.1 - Utilisateurs, quotas et modèle de stockage
Gérer les utilisateurs Le premier compte créé est administrateur. Les comptes supplémentaires se ...
4.2 - Application mobile et sauvegarde automatique
L'application mobile peut envoyer automatiquement les photos et vidéos sélectionnées vers le serv...
4.3 - Créer et gérer une bibliothèque externe
Une bibliothèque externe indexe des photos et vidéos déjà présentes sur le système de fichiers. M...
4.4 - Tâches, files d'attente et intégrité
Immich traite les médias avec des tâches en arrière-plan : extraction de métadonnées, miniatures,...
5 - Accès distant et sécurité
Publier Immich en HTTPS, intégrer Authentik et protéger les comptes et clés d'API.
5.1 - Reverse proxy Caddy
Immich doit être publié à la racine d'un domaine ou sous-domaine. Une publication sous /immich n...
5.2 - Cloudflare, DNS et accès distant
Cloudflare peut fournir le DNS, un proxy public et des certificats entre le client et son réseau....
5.3 - Authentification OIDC avec Authentik
Immich prend en charge OpenID Connect. Ton fournisseur utilise le domaine auth.dreamsaphir.net. ...
5.4 - Sécuriser les comptes, sessions et API
Comptes utiliser un mot de passe unique pour le compte local de secours ; limiter le rôle adminis...
6 - Performances et accélération matérielle
Exploiter le GPU, régler les tâches et surveiller les performances d'Immich.
6.1 - Transcodage NVIDIA avec une Quadro P2000
La NVIDIA Quadro P2000 peut accélérer le transcodage vidéo avec NVENC et réduire la charge CPU. I...
6.2 - Machine learning avec CUDA
Le machine learning Immich fournit la recherche intelligente et la reconnaissance faciale. CUDA e...
6.3 - Concurrence, tâches et choix du stockage
Priorités de stockage PostgreSQL sur SSD si possible. Miniatures sur SSD si la navigation est len...
6.4 - Surveillance, journaux et contrôles
État des conteneurs Docker Compose : docker compose ps docker compose logs --tail=100 docker stat...
7 - Mises à jour et maintenance
Mettre Immich à jour, gérer les changements de version et utiliser les commandes d'administration.
7.1 - Préparer une mise à jour
Une mise à jour Immich peut inclure des changements de schéma PostgreSQL, d'images de conteneurs,...
7.2 - Mettre à jour Docker Compose
Mise à jour standard Depuis le dossier Compose : cd /srv/immich/app docker compose pull docker co...
7.3 - Mettre à jour TrueNAS et migrer vers VectorChord
L'application TrueNAS gère ses images et fichiers Compose. Les changements doivent passer par le ...
7.4 - Commandes d'administration et récupération
L'image immich-server contient la commande immich-admin. Lancer la commande Docker Compose : do...
8 - Stratégie de sauvegarde
Protéger la base, les médias, la configuration et les copies distantes avec des tests de restaura...
8.1 - Périmètre et stratégie 3-2-1
Immich recommande une stratégie 3-2-1 : 3 copies des données ; 2 types de supports ou systèmes ; ...
8.2 - Sauvegarder PostgreSQL
Immich crée automatiquement des dumps PostgreSQL dans : UPLOAD_LOCATION/backups La rétention et l...
8.3 - Snapshots ZFS et réplication TrueNAS
Les snapshots ZFS protègent rapidement l'état d'un dataset. Ils ne remplacent pas un dump Postgre...
8.4 - Copie distante vers Proxmox et validation
Ton environnement utilise déjà une liaison SSH de TrueNAS vers Proxmox. Elle peut transporter une...
9 - Migration complète d'Immich
Inventorier la source, transférer les données et migrer proprement vers une nouvelle installation.
9.1 - Inventaire et plan de migration
Une migration réussie commence par un inventaire. Ne pas arrêter ou supprimer la source tant que ...
9.2 - Préparer et exporter le serveur source
Première copie sans interruption Créer une destination de préparation et copier les médias pendan...
9.3 - Transférer et préparer la destination
Préparer TrueNAS Exemple : /mnt/HDD_DATA_TRUENAS/IMMICH/data /mnt/HDD_DATA_TRUENAS/IMMICH/pgData ...
9.4 - Cas pratique Proxmox vers TrueNAS
Ce cas reprend la migration de ton ancienne instance Proxmox vers TrueNAS. Situation source : VM ...
10 - Restauration et dépannage
Restaurer Immich par l'interface ou la ligne de commande et résoudre les incidents courants.
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 ...
10.2 - Restauration PostgreSQL en ligne de commande
La restauration en ligne de commande est réservée aux cas avancés. Utiliser un nouvel emplacement...
10.3 - Plan de reprise après sinistre
Scénario Le serveur Immich ou son pool principal est perdu. Les éléments disponibles sont : dump ...
10.4 - Erreurs fréquentes et diagnostic
Conteneur PostgreSQL ou pgvecto_upgrade en erreur sudo docker ps -a --format '{{.Names}} {{.Image...