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

• un fichier retiré du chemin est placé dans la corbeille Immich après scan ;
• un fichier déplacé peut être considéré comme un nouvel actif ;
• les albums et descriptions stockés uniquement dans PostgreSQL peuvent être perdus lors d'un déplacement ;
• vider la corbeille d'une bibliothèque en lecture-écriture peut supprimer l'original.

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 :

• https://docs.immich.app/features/libraries/
• https://docs.immich.app/guides/external-library/