4 - Configuration et utilisation quotidienne

Configurer les utilisateurs, les modèles de stockage, la sauvegarde mobile, les bibliothèques et les tâches.

4.1 - Utilisateurs, quotas et modèle de stockage

Gérer les utilisateurs

Le premier compte créé est administrateur. Les comptes supplémentaires se gèrent dans :

Administration > Users

L'administrateur peut créer un compte, réinitialiser son mot de passe, fixer un quota, définir une étiquette de stockage et planifier sa suppression.

Quotas

Un quota limite les uploads internes d'un utilisateur. Les bibliothèques externes ne sont pas comptées dans ce quota.

Vérifier la consommation dans :

Administration > Server Stats

Étiquette de stockage

Sans étiquette, les fichiers utilisent souvent un identifiant utilisateur. Une étiquette rend le chemin plus lisible :

upload/alex/...

Après modification d'une étiquette sur un compte ayant déjà des fichiers, lancer la tâche Storage Migration.

Modèle de stockage

Le modèle peut organiser les originaux dans library. Exemple :

{{y}}/{{y}}-{{MM}}-{{dd}}/{{filename}}

Avant application :

Suppression d'un utilisateur

La suppression désactive le compte puis planifie l'effacement de ses données selon le délai configuré. Une suppression immédiate des actifs est irréversible depuis l'interface.

Avant toute suppression :

  1. vérifier le propriétaire des bibliothèques ;
  2. exporter ou transférer les données utiles ;
  3. déclencher une sauvegarde de la base ;
  4. confirmer le délai de suppression ;
  5. documenter la demande.

Comptes administrateurs

Limiter le nombre d'administrateurs. Conserver un compte local de secours avec un mot de passe fort même si Authentik est utilisé, sauf politique contraire et procédure de récupération testée.

Références :

4.2 - Application mobile et sauvegarde automatique

L'application mobile peut envoyer automatiquement les photos et vidéos sélectionnées vers le serveur Immich.

Configuration initiale

  1. Installer l'application officielle.
  2. Saisir l'URL HTTPS du serveur.
  3. Se connecter avec le compte Immich ou OIDC.
  4. Ouvrir les paramètres de sauvegarde.
  5. Sélectionner les albums inclus.
  6. Exclure les albums inutiles.
  7. Choisir Wi-Fi uniquement ou autoriser les données mobiles.

Premier import

Pour une photothèque importante :

Déduplication

L'application calcule une somme du contenu. Si l'actif existe déjà dans la bibliothèque de l'utilisateur, l'envoi peut être ignoré. La déduplication n'est pas globale entre tous les utilisateurs et bibliothèques.

Synchronisation des albums

L'option de synchronisation crée des albums serveur correspondant aux albums mobiles. Il s'agit d'une synchronisation du téléphone vers le serveur, pas d'une réplication bidirectionnelle complète.

Vérifier les résultats

Dans l'application :

Sur le serveur :

docker compose logs --tail=100 immich-server
df -hT /srv/immich/data

Dans Immich :

Administration > Jobs
Administration > Server Stats

Changement d'URL

Après une migration, mettre à jour l'URL du serveur dans l'application mobile et tester la connexion avant de supprimer l'ancienne instance. Si Authentik est utilisé, les URI de redirection et le domaine doivent également être cohérents.

Important

La présence des photos sur le téléphone et sur Immich crée deux copies, mais ne garantit pas une sauvegarde durable. Une panne, une suppression synchronisée ou une erreur humaine peut toucher les deux. Maintenir une troisième copie hors du serveur.

Référence : https://docs.immich.app/features/mobile-backup/

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.

Monter le dossier

Docker Compose :

services:
  immich-server:
    volumes:
      - ${UPLOAD_LOCATION}:/data
      - /srv/photos:/mnt/external-libraries/photos:ro

Redéployer :

docker compose up -d

TrueNAS : ajouter un stockage supplémentaire avec un chemin interne distinct, par exemple /mnt/external-libraries/photos.

Créer la bibliothèque

  1. ouvrir Administration > External Libraries ;
  2. cliquer sur Create Library ;
  3. choisir le propriétaire ;
  4. ajouter /mnt/external-libraries/photos ;
  5. ajouter les exclusions si nécessaire ;
  6. lancer Scan New Library Files ;
  7. suivre les tâches.

Le propriétaire ne peut pas être changé directement après la création selon le fonctionnement documenté.

Exclusions

Exemple pour ignorer les fichiers RAW dans un sous-dossier :

**/Raw/**

Tester les motifs sur une petite partie avant un scan complet.

Lecture seule

Le suffixe :ro protège les fichiers contre les modifications du conteneur. C'est le choix le plus prudent pour une archive existante. Certaines modifications de métadonnées nécessitent cependant la création de fichiers XMP et ne fonctionneront pas en lecture seule.

Déplacements et suppressions

Diagnostic

docker exec -it immich_server sh -lc \
  'id; find /mnt/external-libraries/photos -maxdepth 2 -type f | head'

Vérifier les montages, permissions, chemins avec / et absence de liens symboliques traversant plusieurs montages.

Références :

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, transcodage vidéo, reconnaissance faciale, recherche intelligente et migration de stockage.

Consulter les tâches

Administration > Jobs

Lors d'un import important, des files actives sont normales. Examiner les journaux si le nombre d'échecs augmente ou si aucune tâche ne progresse.

Ordre de traitement

Après un upload, Immich lance généralement :

  1. extraction des métadonnées ;
  2. génération de miniatures ;
  3. traitement machine learning ;
  4. transcodage selon les paramètres ;
  5. autres tâches planifiées.

Concurrence

Augmenter la concurrence au-delà du nombre de coeurs peut réduire la réactivité sans accélérer le traitement. Procéder par petites étapes et surveiller CPU, mémoire et latence du stockage.

Intégrité système

Immich vérifie :

Les dossiers contrôlés comprennent :

upload
library
thumbs
encoded-video
profile
backups

Les fichiers .immich servent de marqueurs de montage. Ne pas les créer ou supprimer manuellement sans comprendre la cause de l'erreur.

Contrôles serveur

docker compose ps
docker compose logs --tail=200 immich-server
docker stats --no-stream
df -hT
df -i

Sur TrueNAS :

sudo docker logs --tail 200 NOM_CONTENEUR_IMMICH
sudo zpool status
sudo zfs list

Réparer sans aggraver

La variable IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true désactive une protection importante. Ne l'utiliser que pour un diagnostic maîtrisé, jamais comme correction permanente.

Références :