Bibliothèques externes Immich : guide des archives photo en lecture seule

Supposons que vos photos se trouvent déjà dans des dossiers auxquels vous faites confiance. Vous souhaitez disposer d’une chronologie consultable par recherche sans confier le contrôle des originaux à une autre application. Les bibliothèques externes Immich peuvent indexer ces dossiers, tandis qu’un montage en lecture seule limite les écritures par cette connexion. Ce fonctionnement a des limites : l’indexation ne crée aucune copie de sauvegarde, les modifications nécessitent une analyse et certaines modifications de métadonnées effectuées dans l’application risquent de ne pas être enregistrées durablement.

Ce guide vous aide à déterminer si cette organisation convient à vos archives. Il propose un essai sur un petit dossier, dans une installation Docker existante dont l’utilisation est autorisée. Cet essai n’a pas été exécuté ; il ne s’agit ni d’un tutoriel d’installation complet ni d’un banc d’essai de la recherche.

Choisir entre les téléversements gérés et une bibliothèque externe

Quand vos dossiers existants doivent rester la référence

Commencez par déterminer qui contrôle les originaux. Une bibliothèque externe suit des fichiers situés en dehors du stockage géré par Immich et crée des éléments dans la base de données pour permettre leur consultation. Les téléversements gérés placent les originaux dans le stockage géré par Immich, comme l’explique la documentation sur le stockage. Choisissez en fonction de l’endroit où vous souhaitez entretenir vos archives.

Comme l’explique la documentation sur les bibliothèques externes, l’indexation évite d’avoir à téléverser une copie gérée de ces originaux. Il faut néanmoins de l’espace pour la base de données et les éléments générés. Prévoyez les deux.

Le retour d’expérience de Jaisen Mathai offre un exemple concret : il conserve Elodie pour organiser ses archives et utilise des dossiers externes en lecture seule avec Immich. La réécriture de ses données EXIF repose sur une intégration personnalisée. Considérez cela comme sa configuration, et non comme une fonctionnalité intégrée ou un résultat de déploiement obtenu par Optijara.

La distinction entre une source et ses copies compte aussi lors de la préparation des exports d’images et des ressources liées. Ce guide porte sur la transmission de fichiers entre créateurs plutôt que sur la configuration d’Immich, mais la question du contrôle des sources est voisine.

Distinguer les archives, le chemin du conteneur et le propriétaire de la bibliothèque

Un montage en lecture seule limite les écritures, sans définir une politique d’accès

Votre dossier sur l’hôte possède un chemin. Dans un conteneur, ce même dossier peut avoir un autre chemin. Aucun des deux n’indique à Immich à quel compte la bibliothèque doit appartenir. Selon les instructions sur le propriétaire et les chemins, vous choisissez un seul propriétaire à la création et ne pouvez plus le changer ensuite. L’accès administrateur ne fait pas de chaque utilisateur un propriétaire.

Le suffixe :ro empêche Immich de supprimer les originaux ou d’écrire des fichiers annexes par le montage source. Les applications de l’hôte peuvent toujours modifier ces fichiers. Les autorisations de consultation et les sauvegardes nécessitent une attention distincte. Suivez le guide de montage : ajoutez un montage externe distinct, conservez ${UPLOAD_LOCATION}:/data et gardez tous les montages gérés existants.

Voici le parcours de lecture proposé. Aucun déploiement n’a été effectué pour cet article.

La base de données et les éléments générés nécessitent toujours un stockage applicatif accessible en écriture. Seul le montage source est en lecture seule.

Réaliser un petit essai d’archives en lecture seule

Monter un dossier de test et définir la correspondance des chemins

Utilisez la liste de contrôle proposée, Monter, Associer, Analyser, Vérifier, pour limiter la portée de la première tentative. Il s’agit d’un cadre rédactionnel, et non d’une fonctionnalité Immich ou d’une procédure testée par Optijara. Avant de commencer, confirmez que Docker Compose fonctionne et que vous disposez de l’autorisation d’administration. Choisissez des médias de test sans risque, avec des autorisations permettant leur lecture. Excluez les photos privées de production de cet essai.

1. Monter. Ajoutez l’entrée suivante à la liste volumes du service immich-server existant. Remplacez le texte indicatif en majuscules par le chemin absolu du dossier de test sur l’hôte. Conservez chaque montage géré existant. Cet extrait illustratif est incomplet et n’a pas été exécuté ; il ne peut pas servir de fichier Compose autonome.

- /ABSOLUTE/HOST/SAMPLE:/mnt/photos-source:ro

L’application de cette modification nécessite une intervention distincte de l’opérateur. Suivez le guide officiel pour la mise à jour des montages. Aucun redémarrage de conteneur n’est rapporté ici.

1. Associer. Confirmez que /mnt/photos-source est accessible en lecture dans chaque conteneur de serveur ou de processus de traitement séparé concerné. Vérifiez les autorisations effectives. Les conseils de dépannage signalent les montages manquants dans les processus de traitement et les problèmes de liens symboliques : ne supposez donc pas qu’un lien symbolique entre montages fonctionnera.

Créez la bibliothèque dans Administration > Bibliothèques externes et sélectionnez le propriétaire prévu. Saisissez /mnt/photos-source comme chemin d’importation. /ABSOLUTE/HOST/SAMPLE correspond à l’hôte ; Immich a besoin du répertoire visible dans ses conteneurs. Arrêtez-vous si ce répertoire est inaccessible.

Analyser et vérifier avant d’élargir le périmètre

1. Analyser. Ajoutez les exclusions avant l’analyse. Par exemple, utilisez /Raw/ uniquement si vous souhaitez exclure les répertoires nommés Raw et leur contenu, et non tous les fichiers au format brut. Les règles documentées pour les motifs s’appliquent de façon récursive aux chemins complets et ne tiennent pas compte de la casse. Lancez ensuite l’analyse de la bibliothèque.

1. Vérifier. Consignez vos observations. Le tableau ci-dessous constitue un plan de mesure proposé, et non la preuve de tests réalisés.

Gardez les tests de suppression et la création de liens publics en dehors de cet essai. Si le propriétaire ou les limites d’accès diffèrent de votre plan, cessez d’élargir le périmètre et recherchez la cause. Accorder un accès en écriture pour contourner une erreur modifie l’organisation que vous vouliez tester.

Une courte note de préparation permet de consigner l’intention séparément des observations. La valeur relative au chemin d’importation ci-dessous indique le type de chemin requis ; saisissez le répertoire réel /mnt/photos-source dans Immich. Ce JSON est une note, et non une configuration de l’application ou une preuve de réussite.

{
  "workflow": "mount-map-scan-verify",
  "import_path_kind": "container-visible",
  "source_access": "read-only",
  "status": "proposed-unexecuted"
}

Interpréter les analyses et les tâches en arrière-plan sans supposer une synchronisation en temps réel

La découverte ne signifie pas que le traitement est terminé

Trouver un fichier ne représente qu’une partie du travail. Les analyses créent des éléments ; l’extraction des métadonnées et la génération des miniatures ont leurs propres tâches. Les traitements liés à la recherche influent aussi sur la disponibilité. Le guide des bibliothèques externes invite les administrateurs à examiner les tâches Bibliothèque, Génération des miniatures et Extraction des métadonnées. La documentation sur les processus de traitement explique ces traitements en arrière-plan.

L’apparition d’une photo dans la chronologie ne permet pas de savoir si toutes les tâches concernées sont terminées. Examinez leur état et leurs erreurs avant de juger la qualité de la recherche. Ce guide n’établit ni durée de traitement ni exhaustivité des archives.

Pour une vérification hypothétique, sélectionnez un nom de fichier de test connu et notez s’il apparaît pour le propriétaire prévu. Conservez le chemin d’importation et l’état des tâches au moment de l’examen. Si le fichier est absent, enregistrez le contexte de l’erreur avant de modifier les paramètres. Une fois le problème identifié corrigé, répétez la même vérification. Passer à une requête plus simple vous apprendrait peu sur l’utilité de la correction. Même une nouvelle vérification réussie ne dit rien des fichiers non examinés.

Nouvelles analyses, planification et surveillance expérimentale

Les modifications externes nécessitent une nouvelle analyse adaptée ou une actualisation des métadonnées. Immich documente une analyse automatique quotidienne des bibliothèques dont les administrateurs peuvent modifier la planification. Son dispositif de surveillance du système de fichiers est une fonctionnalité expérimentale distincte destinée aux utilisateurs avancés. L’avertissement sur la surveillance précise qu’elle ne fonctionnera probablement pas pour des photos sur un lecteur réseau. Prévoyez des analyses périodiques, sauf si vous avez vérifié un autre fonctionnement pour votre stockage.

Pour les éléments manquants ou non actualisés, vérifiez d’abord la visibilité des sources et les chemins d’importation, puis examinez les exclusions, les autorisations et les tâches. La même documentation indique que le cache du navigateur peut retarder l’affichage des mises à jour. Gardez cette possibilité à l’esprit, sans vous en servir pour écarter un échec de vérification. Trouvez la cause avant d’ajouter d’autres dossiers.

Comprendre ce que les fichiers annexes XMP peuvent conserver

Les champs pris en charge ne représentent pas toute la bibliothèque

L’avertissement général sur les bibliothèques indique que les métadonnées de l’application ne sont pas enregistrées dans les fichiers multimédias externes. La documentation XMP décrit une prise en charge complémentaire des fichiers annexes : certains champs peuvent être lus dans les fichiers annexes adjacents et, avec un accès en écriture adapté, y être réécrits. Cette réécriture ne modifie pas directement les médias originaux.

Les catégories prises en charge comprennent la description et la note, ainsi que la date et l’heure, la localisation et les étiquettes. Les correspondances des champs et les déclenchements automatiques des tâches diffèrent. L’appartenance aux albums et l’organisation des personnes ne doivent pas être considérées comme un format XMP portable complet ; les dispositions de l’interface ne relèvent pas non plus de cette promesse.

Pour IMG_0001.jpg, Immich privilégie IMG_0001.jpg.xmp par rapport à la solution de repli IMG_0001.xmp lorsque les deux existent. Certaines métadonnées extraites sont intégrées à la base de données. La tâche DISCOVER associe les fichiers annexes nouvellement découverts aux médias qui n’en ont pas déjà un associé ; SYNC relit les fichiers annexes associés après des modifications externes. Aucune de ces tâches n’établit une résolution universelle des conflits entre logiciels d’édition.

L’avertissement sur la modification des métadonnées en lecture seule

Lisez cet avertissement avant de tenter des modifications. Selon l’avertissement XMP sur la lecture seule, les modifications de métadonnées d’éléments associés à un fichier annexe en lecture seule peuvent échouer silencieusement, aussi bien dans le fichier annexe que dans la base de données. Un changement apparent dans l’interface ne prouve pas que la base de données l’a enregistré.

Pour cet essai, consultez les archives dans Immich et rédigez leurs métadonnées dans l’outil externe de votre choix. Retirer :ro pour permettre la modification autorise aussi la suppression des fichiers sources, comme l’explique le guide des bibliothèques externes. Cela mérite une décision réfléchie, et non un raccourci de dépannage.

Les métadonnées descriptives ont aussi une autre finalité que les preuves d’attribution. Pour les médias générés ou modifiés, le guide de la provenance des contenus visuels traite des enregistrements de sources et des attestations signées. Une description dans Immich ne peut pas remplacer ces enregistrements.

Vérifier la consultation avec des fichiers connus avant de se fier à la recherche intelligente

Utiliser les noms de fichiers, les dossiers et les dates pour des contrôles ponctuels

Pour cet essai, une simple vérification du nom de fichier est plus utile qu’une démonstration impressionnante de recherche sémantique. Commencez par un nom de fichier connu ou un fragment de celui-ci. Utilisez ensuite le chemin complet ou le dossier et une plage de dates attendue. Ces filtres de recherche documentés permettent d’examiner l’échantillon choisi sans interpréter les correspondances descriptives. Cela reste des contrôles ponctuels, et non la preuve d’une indexation complète.

Si vous avez besoin de la hiérarchie existante, activez la vue facultative des dossiers dans Paramètres du compte > Fonctionnalités > Dossiers, comme l’explique le guide des bibliothèques. Elle offre une autre manière de parcourir les fichiers ; votre outil externe continue d’organiser la source.

La recherche contextuelle CLIP accepte des requêtes libres sans exiger des mots-clés présents littéralement dans les métadonnées. Utilisez-la pour trouver des éléments possibles, et non pour établir la couverture complète des archives. La documentation recommande de tenir compte des langues des requêtes et des ressources nécessaires aux modèles. Les compromis de mémoire et de traitement varient selon le modèle choisi ; un résultat séduisant constitue donc une base insuffisante pour recommander un modèle. Vérifiez la visibilité des noms de fichiers et des chemins avant d’évaluer les recherches descriptives.

Éviter les erreurs qui dissocient les fichiers de leur historique dans la bibliothèque

Déplacer un fichier n’est pas un simple renommage sans conséquence dans la base de données

Fixez l’organisation des sources avant de consacrer du temps à leur classement dans l’application. Selon le comportement documenté des déplacements, déplacer un fichier source au sein d’une bibliothèque peut créer un nouvel élément lors de l’analyse suivante et faire perdre les métadonnées antérieures propres à Immich ou les associations aux albums. Ne supposez pas que la base de données suivra une réorganisation du système de fichiers.

La suppression d’un fichier source déplace son élément dans la corbeille lors de l’analyse suivante. Retirer tous les chemins d’importation qui le couvrent a le même effet. Une entrée dans la corbeille n’est pas une copie de l’original manquant ; restaurez le fichier source lui-même.

Plusieurs erreurs courantes peuvent être évitées :

• Si vous avez saisi le chemin de l’hôte dans l’interface, remplacez-le par le chemin d’importation visible dans le conteneur.
• Un montage sur le seul conteneur de l’API ne suffit pas lorsque les processus de traitement concernés ont besoin du même chemin source accessible en lecture.
• Corrigez l’absence de :ro avant d’analyser davantage de dossiers.
• Planifiez des analyses périodiques pour votre stockage plutôt que de supposer que la surveillance fonctionne partout.
• Traitez avec prudence les modifications apparentes de métadonnées, compte tenu de l’avertissement XMP sur la lecture seule.

Répétez le petit essai chaque fois qu’une hypothèse de départ change.

Fixer les limites avant d’utiliser des archives plus volumineuses

Stockage, partage et maintenance continue

Avant d’élargir le périmètre, confirmez le propriétaire prévu et l’accessibilité en lecture des chemins dans les conteneurs concernés. Vérifiez que le montage source reste en lecture seule et examinez les observations sur l’échantillon. Résolvez les erreurs de tâches inexpliquées. Convenez de l’endroit où les métadonnées seront rédigées et choisissez une planification des analyses. Toute vérification non effectuée reste à faire.

L’indexation n’ajoute aucune copie de vos originaux. Les exports de base de données contiennent des métadonnées, et non des photos ou des vidéos : protégez donc les dossiers sources externes séparément des données gérées par Immich. Les procédures de sauvegarde et de restauration sortent du cadre de ce guide.

Les autorisations de consultation doivent faire l’objet d’un examen distinct. Le partage dans Immich distingue les lecteurs d’albums des éditeurs. L’accès partenaire peut couvrir une bibliothèque entière, tandis que les liens publics proposent des options comme un mot de passe ou une date d’expiration. Ne modifiez pas le partage pendant l’essai.

Prévoyez la maintenance de l’installation et le stockage des médias générés, ainsi que les ressources des modèles et le dépannage des tâches. Examinez la confidentialité et l’exposition séparément des autorisations d’écriture du système de fichiers. Aucune économie ni aucun résultat en matière de sécurité ne sont promis. L’indexation externe convient lorsque vous souhaitez utiliser Immich pour parcourir des archives entretenues ailleurs et pouvez accepter les limites des métadonnées. Si une synchronisation avec écriture est indispensable, réglez cette question avant d’élargir le périmètre.