Deze tutorial voor beginners loste een echte bron van verwarring op: de naam en het pad die in ZimaOS Bestanden worden weergegeven, zijn niet automatisch het pad dat een applicatie in zijn Docker-container ziet. De oorspronkelijke poster gebruikte de webterminal om mountpunten van schijven te inspecteren en koppelde vervolgens de hostopslagmap in Immich of Syncthing aan een eenvoudiger containerpad, zoals /SYNC.
In de thread verscheen later een belangrijke correctie: onbewerkte mountpaden moeten niet worden beschouwd als de voorkeursinterface voor appopslag op de lange termijn wanneer ZimaOS een beheerd opslagpad kan bieden. Het huidige ZimaOS maakt dit veel eenvoudiger dan de werkwijze uit 2025.
De oorspronkelijke tutorial begon in de ontwikkelaarsmodus
De gebruiker gebruikte lsblk om mountpunten te inspecteren
Open de appinstellingen en voeg een volume toe
De kolommen Host en Container betekenen verschillende dingen
Als het containerpad /SYNC, dan moet de applicatie /SYNC of een submap zoals /SYNC/Photos. Het mag niet opnieuw naar het mountpad op de host verwijzen.
Een communityreactie waarschuwde tegen onbewerkte /mnt-paden
Een andere deelnemer merkte op dat directe paden naar onbewerkte mounts kunnen veranderen na het vernieuwen van een schijf, het opnieuw opbouwen van een pool of andere opslagbewerkingen, en aannames in de opslaglaag van ZimaOS kunnen omzeilen.
De beantwoorder raadde aan om stabiele, door ZimaOS beheerde opslag te koppelen, zoals /DATA/Media of de beoogde AppData-locatie, in plaats van een app te bouwen rond een willekeurige onbewerkte mount-ID.
IceWhale verduidelijkte dat externe media standaard onder /media staan
Zima-Giorgio voegde eraan toe dat paden naar externe opslagmedia standaard onder /media standaard. Die officiële toelichting helpt externe opslag te onderscheiden van de voorbeelden van interne applicatiegegevens onder /DATA.
Het huidige ZimaOS maakt het padmodel explicieter
In augustus 2026 vertelde de oorspronkelijke auteur van de handleiding aan een latere gebruiker dat nieuwere ZimaOS-versies dit proces veel eenvoudiger maakten.
De huidige richtlijnen van IceWhale leggen uit hoe hostopslag en containerpaden van ZimaOS in appinstellingen aan containers worden toegewezen. Begin daar voordat je handmatig paden samenstelt op basis van uitvoer van aankoppelingen op laag niveau.
Gebruik de bestandskiezer of beheerde opslag wanneer beschikbaar
Voor normale apps is de veiligste huidige werkwijze om in de volume-instellingen van de app een echte map op de beoogde ZimaOS-opslagruimte te selecteren, het door de app verwachte containerpad te kiezen of te behouden, op te slaan en dat containerpad vervolgens in de applicatie te gebruiken.
Gebruik geen onbewerkt apparaatknooppunt als applicatiemap
De bronscreenshot bevat een pad dat begint met /dev/... in een experimentele volumetoewijzing. Een blokapparaatknooppunt is niet hetzelfde als een aangekoppelde map van een bestandssysteem. Normale applicaties zoals Syncthing en Immich moeten een aangekoppelde map ontvangen, geen niet-aangekoppeld onbewerkt schijfapparaat.
/DATA is een ZimaOS-gegevenslocatie, geen tijdelijke aanduiding voor elke schijf
Een latere beginner vroeg of /DATA betekent simpelweg: “begin elk pad hier.” Dat is niet zo. /DATA is een beheerde ZimaOS-gegevenslocatie die wordt gebruikt voor systeembeheerde applicatie- en gebruikersgegevens. Afzonderlijke externe opslag kan verschijnen onder /media of een ander beheerd opslagpad, afhankelijk van hoe ZimaOS het heeft geregistreerd.
De belangrijkste regel is om de daadwerkelijke hostmap uit de beoogde opslagruimte te selecteren en deze vervolgens aan een stabiel containerpad toe te wijzen.
De auteur van de handleiding zei later dat nieuwere ZimaOS-versies dit eenvoudiger maken
In augustus 2026 keerde de oorspronkelijke auteur terug en vertelde een andere beginner dat nieuwere ZimaOS-releases de workflow vereenvoudigen. Die latere opmerking bevestigt de historische afbakening: gebruik de terminalscreenshots uit 2025 om het onderscheid tussen host- en containerpaden te begrijpen, niet als vereiste om elk huidig aankoppelpunt handmatig te achterhalen.
Veelgestelde vragen over toegang tot externe schijven
Welke kant van een Docker-volume is het daadwerkelijke schijfpad?
De hostzijde.
Welk pad moet Immich, Syncthing of een andere app intern gebruiken?
Het pad aan de containerzijde dat in de volumetoewijzing is geconfigureerd.
Moet elke app rechtstreeks naar /mnt of een apparaatknooppunt verwijzen?
Nee. Geef de voorkeur aan stabiele, beheerde opslagpaden wanneer ZimaOS die aanbiedt.
Waar zei IceWhale dat externe media standaard worden aangekoppeld?
Zima-Giorgio zei dat externe opslagmedia zich bevinden onder /media standaard.
