Immich : ajouter une bibliothèque externe (Synology)

Vous êtes nombreux à utiliser et apprécier Immich sur votre NAS Synology. Cependant, certains rencontrent des difficultés lorsqu’il s’agit d’ajouter des photos déjà présentes sur le NAS, depuis un autre dossier que celui d’Immich. Heureusement, il existe une solution simple et rapide…

immich synology ajout - Immich : ajouter une bibliothèque externe (Synology)

Immich, ajouter une bibliothèque externe

Dans ce guide, nous allons voir comment ajouter une bibliothèque externe (un dossier avec des photos) à Immich en suivant deux étapes essentielles : ajouter un dossier au conteneur Docker et le déclarer dans Immich.

1. Modification du conteneur Docker

Ci-dessous, vous retrouverez 2 méthodes pour ajouter un dossier avec vos photos dans Docker.

Via le docker-compose

La première méthode consiste à modifier le fichier docker-compose.yaml (lien ici fourni dans le précédent article) en ajoutant une ligne dans la section volumes du service immich-server.

ajout docker compose - Immich : ajouter une bibliothèque externe (Synology)

Voici un exemple de ligne à ajouter :

    - /volume1/MonDossier/mesPhotos:/mnt/media/mesPhotos:ro

Voici quelques explications :

  • /volume1/MonDossier/mesPhotos : c’est le chemin du dossier sur le NAS
  • /mnt/media/mesPhotos : chemin d’accès dans le conteneur
  • :ro : accès en lecture seule (read-only)

Vous pourrez ajouter un autre dossier (ou plus), en ajoutant une autre ligne et en modifiant le chemin d’accès du conteneur :

- /volume1/MonDossier/PhotosdeVacances:/mnt/media/PhotosVacances:ro

Redémarrer le conteneur :

  1. Ouvrez Container Manager
  2. Accédez au menu Projet sur la gauche
  3. Sélectionnez immich et cliquez sur Action > Nettoyer
  4. Attendez quelques secondes puis cliquez sur Fermer
  5. Cliquez de nouveau sur Action > Créer

Voila, c’est terminé… Vous pouvez passer à l’étape suivante Ajouter la bibliothèque dans Immich.

Via l’interface de gestion des conteneurs

La seconde méthode consiste à modifier directement le conteneur Immich en lui-même :

  1. Ouvrez Container Manager et accédez au menu Conteneur
  2. Cliquez sur immich_server
  3. Cliquez sur le bouton Arrêter (en haut à droite)
  4. Allez sur l’onglet Paramètres et descendez sur Paramètres du volume
  5. Cliquez sur le bouton  Ajouter un dossier et sélectionnez votre dossier photo, puis indiquez /mnt/media/mesPhotos comme chemin interne
  6. Cliquez sur le bouton Sauvegarder, puis sur Démarrer

Note importante sur les droits d’accès

Selon la version de DSM et vos paramétrages, le dossier /MonChemin/photos sur le NAS peut être restreint en accès. Pour que Docker puisse y accéder :

  1. Ouvrez File Station
  2. Faites un clic droit sur votre dossier photo et sélectionnez Propriétés
  3. Allez sur l’onglet Permissions et cliquez sur le bouton Créer
  4. Sélectionnez le groupe SYSTEM et cochez Lire
  5. Cliquez enfin sur le bouton Effectué

system synology dossier - Immich : ajouter une bibliothèque externe (Synology)

2. Ajouter la bibliothèque dans Immich

Après avoir ajouté le dossier au conteneur, il faut l’intégrer dans l’outil Immich en lui-même. Cette opération n’est pas automatique. Voici les étapes à suivre :

  1. Connectez-vous à l’interface Web Immich http://AdresseIP:2283
  2. Cliquez sur l’icône de votre profil en haut à droite
  3. Allez sur Administration > Bibliothèque externe
  4. Cliquez sur Créer une bibliothèque
  5. Sélectionnez un propriétaire et validez en cliquant sur Créer
  6. Cliquez sur les trois petits points à droite de la bibliothèque et sélectionnez Modifier les chemins d’importation
  7. Ajoutez le chemin déclaré précédemment /mnt/media/mesPhotos dans notre exemple
  8. Cliquez sur Sauvegarder

Attention, ce n’est pas fini !

analyser bibliotheque immich - Immich : ajouter une bibliothèque externe (Synology)

Pour que Immich prenne en compte ce nouvel ajout, il faut lancer une analyse. Le plus simple, c’est de cliquer sur le bouton en haut Analyser toutes les bibliothèques (voir image ci-dessus). Selon la quantité de photos et vidéos, l’analyse peut prendre un certain temps.

Voila, vous pouvez maintenant profiter pleinement de vos collections photos et vidéos sur Immich !

  1. Bonjour et merci pour ce complément de tuto.
    Cependant je ne comprends pas pourquoi l’accès du répertoire photo en lecteur seul [ro] ?
    Si je souhaite modifier ou mettre à jour une balise, une étiquette ou une position GPS dans la photo même, cela ne sera pas possible ?

  2. Hello,

    Top ce complément de tuto.

    Mon arborescence contient des espaces, ce qui pose problème lors de la création via le docker-compose.yaml.
    Voici une syntaxe qui fonctionne chez moi :

    – « /volume1/MonDossier/Mes Photos Sauvegardées:/mnt/media/Mes Photos Sauvegardées:ro »

  3. Bonjour
    J’essaye désespérément déjà d’installer immich en suivant soit :
    – votre tuto: https://www.cachem.fr/immich-nas-synology/...
    https://www.sigalou-domotique.fr/jinstalle-immich-sur-mon-nas-synology
    https://mariushosting.com/how-to-install-immich-on-your-synology-nas/, via portainer
    aucun ne fonctionne
    Le dernier en date (celui de Marius) m’indique enfin une erreur sur le docker immish-server :

    [Nest] 16 – 02/17/2025, 12:48:25 AM ERROR [TypeOrmModule] Unable to connect to the database. Retrying (9)…

    Error: Connection terminated due to connection timeout

    at Connection. (/usr/src/app/node_modules/pg/lib/client.js:131:73)

    at Object.onceWrapper (node:events:638:28)

    at Connection.emit (node:events:524:28)

    at Socket. (/usr/src/app/node_modules/pg/lib/connection.js:62:12)

    at Socket.emit (node:events:524:28)

    at TCP. (node:net:351:12)

    [Nest] 16 – 02/17/2025, 12:48:25 AM ERROR [ExceptionHandler] Error: Connection terminated due to connection timeout

    at Connection. (/usr/src/app/node_modules/pg/lib/client.js:131:73)

    at Object.onceWrapper (node:events:638:28)

    at Connection.emit (node:events:524:28)

    at Socket. (/usr/src/app/node_modules/pg/lib/connection.js:62:12)

    at Socket.emit (node:events:524:28)

    at TCP. (node:net:351:12)

    api worker exited with code 1

    je vois bien un soucis de DB mais dans les 2 premières installations je ne vois pas bien le soucis, surtout que beaucoup de monde on réussi.
    J’espère que ce n’est pas lié au soucis Synology + Docker de votre article :
    https://www.cachem.fr/synology-container-manager-mise-jour-interroge/

    1. Etant tres novice je ne suis pas sur de ma reponse mais elle est sans risque.
      j’avais la meme chose immich-server plantait sans trouver la database. ChatGPT a galéré et puis Marius lui meme m’a répondu:
      As tu bien créé les permissions du dossirr/docker/immich comme au debut de son tuto?
      (sa réponse:
      Your current PUID and PGID user doesn’t have read write permissions to the docker folder in Control Panel / User & Groups / Select your current NAS user / Edit tab / add read write permissions to the docker folder.

      You can also try to add everyone read write permissions to the Immich folder like this other article from Step 5 to Step 9: https://mariushosting.com/how-to-install-viewtube-...)

      Pour moi tout a fonctionné nickel alors que j’avais passé deux nuits de galere avec ChatGPT!

      le tuto de Marius est parfait.

  4. Savez-vous s’il est possible de partager facilement le /photo du NAS ? Car il n’est pas possible d’autoriser le group SYSTEM à ma connaissance.

    1. oui, je l’ai fait en utilisant le tutoriel ci-dessus méthode 2 Par contre maintenant container demande de dupliquer le server pour ajouter un nouveau chemin de dossier. tu dupliques en modifiant puis tu supprimes l’ancien Immich server et ça roule.
      Mais ça marche vraiment bien.

  5. Bonjour,

    Si je veux rajouter rajouter a ma bibliothèque externe mon dossier en ecriture, Je rajoute « rw » après le « ro » de quelle manière ?
    « :ro:rw » ?

  6. si quelqu’un pouvait retranscrire ce tuto « Immich : ajouter une bibliothèque externe (Synology) » à la methode Portainer de Marius (tres utilisée) ce serait super, notamment s’il faut modifier les volumes de son fichier compose

    De plus ici, dans la section « 2. Ajouter la bibliothèque dans Immich »
    Cliquez sur les trois petits points à droite de la bibliothèque et sélectionnez Modifier les chemins d’importation nes emble plus exister dans l’interface actuelle (Immich 2.6.3)
    merci

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur la façon dont les données de vos commentaires sont traitées.