Solution communautaire

Permettre aux applications ZimaOS d’accéder aux disques externes : chemins hôtes, chemins des conteneurs et mappage actuel du stockage

A November 2025 beginner tutorial showing how to identify a storage mount point and map it into an app with separate host and container paths. Community replies corrected the raw-mount approach, IceWhale clarified external media lives under /media by default, and the author later noted newer ZimaOS releases make the process easier.

Ce tutoriel pour débutants résolvait une véritable source de confusion : le nom et le chemin affichés dans Fichiers de ZimaOS ne correspondent pas automatiquement au chemin que l’application voit à l’intérieur de son conteneur Docker. L’auteur original a utilisé le terminal web pour inspecter les points de montage des disques, puis a mappé le dossier de stockage de l’hôte dans Immich ou Syncthing vers un chemin de conteneur plus simple, tel que /SYNC.

La discussion a ensuite reçu une correction importante : les chemins de montage bruts ne doivent pas être considérés comme l’interface privilégiée à long terme pour le stockage des applications lorsque ZimaOS peut fournir un chemin de stockage géré. Les versions actuelles de ZimaOS rendent cela bien plus simple qu’avec le processus de 2025.

Le tutoriel original a commencé en mode développeur

Écran des paramètres de ZimaOS affichant le mode développeur et le terminal web
Le tutoriel source utilisait le terminal web intégré pour identifier où les périphériques de stockage étaient montés.

L’utilisateur a utilisé lsblk pour inspecter les points de montage

Terminal ZimaOS affichant la sortie de lsblk avec les points de montage du stockage mis en évidence
Le champ important était le point de montage, mais les réponses ultérieures ont mis en garde contre le fait de considérer chaque chemin de montage brut comme une cible stable pour le stockage des applications.

Ouvrez les paramètres de l’application et ajoutez un volume

Menu des applications ZimaOS avec Configuration sélectionné
Le panneau de configuration de l’application est l’endroit où le stockage de l’hôte est exposé au conteneur.

Les colonnes Hôte et Conteneur ont des significations différentes

Paramètres de volume de l’application Syncthing montrant un chemin de stockage de l’hôte ZimaOS mappé vers /SYNC à l’intérieur du conteneur
La partie gauche correspond au chemin réel sur l’hôte ZimaOS ; la partie droite correspond au chemin que l’application voit à l’intérieur de son conteneur.

Si le chemin du conteneur est /SYNC, l’application doit alors utiliser /SYNC ou un sous-dossier tel que /SYNC/Photos. Il ne faut pas le rediriger vers le chemin de montage de l’hôte.

paramètres des dossiers Syncthing utilisant /SYNC comme chemin de dossier interne
Une fois le volume mappé, l’application fonctionne uniquement avec le chemin côté conteneur.

Un membre de la communauté a déconseillé les chemins bruts sous /mnt

Un autre participant a souligné que les chemins de montage bruts directs peuvent changer après une actualisation du disque, une reconstruction du pool ou d’autres opérations de stockage, et peuvent contourner les hypothèses de la couche de stockage de ZimaOS.

Le répondant a recommandé de mapper un stockage stable géré par ZimaOS, tel que /DATA/Media ou l’emplacement AppData prévu, plutôt que de créer une application autour d’un identifiant de montage brut arbitraire.

IceWhale a clarifié que les supports externes se trouvent par défaut sous /media

Zima-Giorgio a ajouté que les chemins des supports de stockage externes sont placés sous /media par défaut. Cette note officielle aide à distinguer le stockage externe des exemples de données d’application internes présentés sous /DATA.

Les versions actuelles de ZimaOS rendent le modèle des chemins plus explicite

En août 2026, l’auteur du tutoriel original a indiqué à un utilisateur ultérieur que les versions plus récentes de ZimaOS avaient grandement simplifié ce processus.

Les recommandations actuelles d’IceWhale expliquent comment le stockage hôte de ZimaOS et les chemins des conteneurs sont mappés dans les paramètres des applications. Commencez par là avant de construire manuellement des chemins à partir de la sortie de montage de bas niveau.

Utilisez le sélecteur de fichiers ou le stockage géré lorsqu’il est disponible

Pour les applications courantes, le processus actuel le plus sûr consiste à sélectionner un véritable dossier dans l’espace de stockage ZimaOS souhaité, dans les paramètres de volumes de l’application, à choisir ou conserver le chemin de conteneur attendu par l’application, à enregistrer, puis à utiliser ce chemin de conteneur dans l’application.

N’utilisez pas un nœud de périphérique brut comme dossier d’application

La capture d’écran source comprend un chemin commençant par /dev/... dans un mappage de volumes expérimental. Un nœud de périphérique bloc n’est pas la même chose qu’un répertoire de système de fichiers monté. Les applications courantes comme Syncthing et Immich doivent recevoir un dossier monté, et non un périphérique disque brut non monté.

/DATA est un emplacement de données ZimaOS, pas un espace réservé pour chaque disque

Un autre débutant a demandé si /DATA signifie simplement « commencer chaque chemin ici ». Ce n’est pas le cas. /DATA est un emplacement de données ZimaOS géré, utilisé pour les applications et les données utilisateur gérées par le système. Un stockage externe distinct peut apparaître sous /media ou un autre chemin de stockage géré, selon la manière dont ZimaOS l’a enregistré.

La règle importante consiste à sélectionner le véritable dossier hôte dans l’espace de stockage souhaité, puis à le mapper vers un chemin stable dans le conteneur.

L’auteur du tutoriel a ensuite indiqué que les versions récentes de ZimaOS facilitent les choses

En août 2026, l’auteur original est revenu et a expliqué à un autre débutant que les versions plus récentes de ZimaOS simplifiaient le processus. Ce commentaire ultérieur confirme la limite historique : utilisez les captures d’écran du terminal de 2025 pour comprendre les chemins côté hôte et côté conteneur, et non comme une obligation de découvrir manuellement chaque point de montage actuel.

FAQ sur l’accès aux disques externes

Quel côté d’un volume Docker correspond au véritable chemin du disque ?

Le côté hôte.

Quel chemin Immich, Syncthing ou une autre application doit-elle utiliser en interne ?

Le chemin côté conteneur configuré dans le mappage de volumes.

Faut-il diriger chaque application directement vers /mnt ou vers un nœud de périphérique ?

Non. Privilégiez les chemins de stockage gérés et stables lorsque ZimaOS les fournit.

Où IceWhale a-t-il indiqué que les supports externes sont montés par défaut ?

Zima-Giorgio a indiqué que les supports de stockage externes se trouvent sous /media par défaut.