# Bibliothèque externe Immich introuvable ou vide : les contrôles utiles

> Vérifiez le montage, le chemin interne, les droits et les exclusions dans cet ordre. Testez un seul fichier lisible depuis le conteneur avant de lancer.

- Canonical: https://cloudzat.com/fr/immich-external-library-not-working/
- Published: 2026-11-15
- Updated: 2026-11-15
- Author: Kayla Idayi
- Site: https://cloudzat.com/
- LLM index: https://cloudzat.com/llms.txt

## Content

SAUVEGARDE ET PHOTOTHÈQUES

# Bibliothèque externe Immich introuvable ou vide : les contrôles utiles

Un dossier visible sur le NAS peut rester invisible pour Immich. La distinction entre le chemin de l’hôte et celui du conteneur explique une grande partie des bibliothèques externes qui ne se remplissent pas.

Vérification éditoriale : 15 novembre 2026 · France

 Réponse rapideÉtapes à suivreDécisions et vérificationsCas pratiquesComparer les situationsQuestions fréquentes

## Réponse rapide

Vérifiez le montage, le chemin interne, les droits et les exclusions dans cet ordre. Testez un seul fichier lisible depuis le conteneur avant de lancer une nouvelle analyse de toute la collection.

## Étapes à suivre

1. ### Avant de commencer Choisissez le nom d’un fichier dont vous connaissez l’emplacement et la présence réelle. Notez le chemin sur l’hôte, son montage dans le conteneur et le chemin configuré dans la bibliothèque externe. Conservez les erreurs de la dernière analyse. Ce parcours précis permet de localiser le premier niveau auquel le fichier devient invisible.
 1. ### Définir le bon périmètre Comparez le volume déclaré dans Compose avec le chemin d’importation enregistré dans Immich. Le chemin de droite du montage est celui attendu dans le conteneur. Contrôlez aussi que le disque ou partage source est réellement monté.
 1. ### Appliquer les réglages adaptés Vérifiez que le processus peut lister et lire une petite photo à cet emplacement. Contrôlez également les volumes des workers séparés, les permissions des dossiers parents et les liens symboliques qui traversent des montages.
 1. ### Terminer le premier essai Examinez les exclusions et le format du fichier, puis lancez une analyse limitée. Si la source est sur le réseau, utilisez un scan planifié plutôt que de conclure à une panne parce que la surveillance automatique ne détecte rien.

## Décisions et vérifications

### La limite à comprendre

Ne recréez pas toute la bibliothèque avant d’avoir vérifié le chemin : un changement d’emplacement peut affecter les associations et métadonnées propres à Immich. Évitez également de lancer un nettoyage alors que le stockage source est indisponible.

### Vérifier le résultat

La photo test doit apparaître et son original doit s’ouvrir. Ajoutez ensuite un second fichier, relancez le scan et vérifiez que la détection fonctionne sans modifier les originaux.

### Maintenir un résultat fiable

Refaites la vérification après le prochain redémarrage du serveur ou du stockage. Le montage doit être disponible avant que vous considériez les analyses comme fiables. Si la panne revient, examinez l’ordre de démarrage et la disponibilité du partage plutôt que de reconstruire à nouveau la bibliothèque et ses albums.

## Suivre le chemin du fichier jusqu’à la bibliothèque Immich

### Vérifier le fichier à chaque niveau du montage

Un fichier présent sur le NAS peut rester invisible dans le conteneur. Commencez par confirmer que le dossier source contient réellement les images attendues sur la machine hôte. Vérifiez ensuite le montage déclaré pour le service Immich et le chemin visible à l’intérieur du conteneur. Enfin, comparez ce dernier chemin avec le chemin d’importation indiqué dans la bibliothèque externe. Ces trois valeurs peuvent se ressembler sans être identiques.

Par exemple, un dossier hôte nommé /mnt/photos-famille peut être présenté dans le conteneur sous /photos. L’interface Immich doit alors viser le chemin qu’elle peut réellement lire, pas simplement le nom connu du NAS. Cet exemple illustre la relation entre les chemins ; il ne constitue pas une configuration à copier sans adaptation. Conservez le chemin existant tant que vous n’avez pas compris celui qui est erroné.

### Rechercher un partage absent avant de modifier les fichiers

Après un redémarrage, un partage réseau ou un disque externe peut ne pas être monté comme prévu. Le dossier servant de point de montage peut exister tout en étant vide. Dans ce cas, relancer des analyses ou nettoyer des éléments manquants ne rétablit pas les originaux. Vérifiez d’abord la disponibilité du stockage et la présence de quelques fichiers connus depuis l’hôte.

Si le stockage n’est pas disponible, rétablissez-le par la procédure adaptée à votre système puis contrôlez la lecture par Immich. Évitez de créer une nouvelle bibliothèque vide ou de réimporter toute la collection pour compenser une interruption temporaire. Ces actions peuvent ajouter des doublons ou compliquer l’organisation sans corriger le problème de départ. Gardez les journaux et l’état initial pour pouvoir expliquer ce qui s’est passé.

### Contrôler les permissions sur tout le chemin

La lecture d’un fichier dépend des droits sur ce fichier mais aussi de la traversée des dossiers parents. Un compte administrateur du NAS peut voir les photos alors que le compte qui exécute Immich ne peut pas traverser un répertoire intermédiaire. Identifiez l’utilisateur ou le groupe du service et vérifiez ses droits effectifs. Corrigez la permission nécessaire au bon endroit plutôt que d’ouvrir toute l’arborescence à tous les utilisateurs.

Un montage en lecture seule permet normalement la consultation et l’indexation des originaux, mais empêche les opérations qui exigent une écriture. Si votre difficulté concerne une suppression ou un fichier annexe, distinguez-la d’un refus de lecture. Retirer la lecture seule n’est pas une réponse générale à une bibliothèque vide. Cela élargit les opérations possibles et doit correspondre à un besoin compris, avec une sauvegarde des originaux.

### Séparer absence d’indexation et problème d’affichage

Lorsque le chemin est lisible, vérifiez que la bibliothèque appartient au compte attendu, que ses chemins d’importation sont corrects et qu’une analyse a réellement été lancée. Consultez la file de tâches et les erreurs associées. Les fichiers présents sur disque ne deviennent pas tous visibles par la seule création d’un dossier : le logiciel doit les analyser et prendre en charge leurs formats.

Prenez une image connue et compatible comme référence. Si elle apparaît mais qu’un autre format manque, examinez ce fichier précis, sa taille et les erreurs correspondantes. Si les éléments sont indexés mais que leurs aperçus sont absents, regardez les tâches de génération et les journaux. Une miniature en échec n’est pas la même panne qu’un original introuvable ; mélanger ces deux symptômes conduit souvent à déplacer inutilement les fichiers.

### Réparer sans effacer l’historique utile

Ne déplacez pas en masse les originaux pendant le diagnostic. [La documentation Immich signale](https://docs.immich.app/features/libraries/) que le changement de chemin d’un élément externe peut modifier la manière dont il est identifié après une analyse et affecter les métadonnées conservées dans l’application. Les informations d’album ou de description ne doivent pas être supposées intégralement inscrites dans le fichier image lui-même. Sauvegardez la base et les originaux avant une réorganisation importante.

Après correction, relancez une analyse ciblée et vérifiez plusieurs éléments : un ancien fichier, un nouveau, une vidéo et un sous-dossier profond. Téléchargez un original pour confirmer que le chemin fonctionne au-delà de la miniature. Contrôlez ensuite le compte qui doit consulter la bibliothèque et les éventuels partages. Si l’erreur persiste, fournissez à l’assistance la version, le montage anonymisé et le message précis, sans publier vos secrets ni une liste de fichiers privés.

## Comparer les situations

| Situation / composant | Rôle / action | Point à vérifier |
| --- | --- | --- |
| Dossier vide dans le conteneur | Montage ou stockage absent | Comparer hôte, conteneur et import |
| Présent mais illisible | Permissions effectives | Dossiers parents et compte de service |
| Original lisible, aperçu absent | Indexation ou tâche de miniature | File de tâches et fichier concerné |

## Questions fréquentes

 Dois-je supprimer la bibliothèque pour la recréer ?

Pas avant d’avoir contrôlé les montages, les droits et les analyses. Une suppression puis recréation peut compliquer les associations et ne corrige pas un stockage absent. Gardez une sauvegarde de la base et des originaux avant une réorganisation de la bibliothèque.

 Pourquoi l’administrateur du NAS voit-il les images mais pas Immich ?

Le service utilise ses propres montages et droits. Vérifiez le chemin visible dans le conteneur et les permissions du compte qui exécute Immich, y compris sur les dossiers parents. Les droits de votre session administrateur ne prouvent pas ceux du service.

## Guides associés

- [Partager une bibliothèque externe Immich entre plusieurs utilisateurs](https://cloudzat.com/fr/immich-external-library-multiple-users/)
 - [Accéder à Immich depuis l’extérieur : choisir un accès privé ou HTTPS](https://cloudzat.com/fr/access-immich-from-outside/)
 - [Sauvegarder Immich : photos, base de données et restauration](https://cloudzat.com/fr/immich-backup/)
 - [Immich manque de mémoire : identifier le service et réduire la charge](https://cloudzat.com/fr/immich-out-of-memory/)

## Documentation officielle

Ce guide associe la documentation officielle actuelle à des contrôles pratiques de récupération. Il ne prétend pas avoir testé votre installation. Les menus et procédures peuvent varier selon la version ; consultez la documentation correspondant à votre logiciel.

- [docs.immich.app — libraries](https://docs.immich.app/features/libraries/)
 - [docs.immich.app — external library](https://docs.immich.app/guides/external-library/)
 - [docs.immich.app — backup and restore](https://docs.immich.app/administration/backup-and-restore/)

---

Machine-readable alternate. Cite or link to the canonical Cloudzat URL above. For changing prices, availability, forecasts, compatibility, or calculator results, fetch the canonical page at answer time.
