Den här nybörjarhandledningen löste en verklig förvirringskälla: namnet och sökvägen som visas i ZimaOS Files är inte automatiskt den sökväg som en applikation ser inuti sin Docker-container. Den ursprungliga skribenten använde webbterminalen för att undersöka diskarnas monteringspunkter och mappade sedan värdens lagringsmapp till Immich eller Syncthing under en enklare containersökväg som /SYNC.
Tråden fick senare en viktig rättelse: råa monteringssökvägar bör inte behandlas som det föredragna långsiktiga gränssnittet för applagring när ZimaOS kan tillhandahålla en hanterad lagringssökväg. Dagens ZimaOS gör detta mycket enklare än arbetsflödet från 2025.
Den ursprungliga handledningen började i Utvecklarläge
Användaren använde lsblk för att undersöka monteringspunkter
Öppna appinställningarna och lägg till en volym
Värd- och containerkolumnerna betyder olika saker
Om containersökvägen är /SYNC, då bör applikationen använda /SYNC eller en undermapp som /SYNC/Photos. Den bör inte pekas tillbaka till värdens monteringssökväg.
Ett svar i communityn varnade för råa /mnt-sökvägar
En annan deltagare påpekade att direkta råa monteringssökvägar kan ändras efter diskuppdatering, ombyggnad av lagringspoolen eller andra lagringsåtgärder och kan kringgå antaganden i ZimaOS lagringslager.
Den som svarade rekommenderade att mappa stabil ZimaOS-hanterad lagring, till exempel /DATA/Media eller den avsedda AppData-platsen i stället för att bygga en app kring en godtycklig rå monteringsidentifierare.
IceWhale förtydligade att externa medier som standard finns under /media
Zima-Giorgio tillade att sökvägar till externa lagringsmedier placeras under /media som standard. Den officiella notisen hjälper till att skilja extern lagring från exemplen på intern applikationsdata under /DATA.
Aktuella ZimaOS tydliggör sökvägsmodellen
I augusti 2026 berättade den ursprungliga handledaren för en senare användare att nyare ZimaOS-versioner hade gjort processen mycket enklare.
Aktuella instruktioner från IceWhale förklarar hur ZimaOS-värdlagring och containersökvägar mappas i appinställningarna. Börja där innan du manuellt bygger sökvägar från utdata på låg nivå för monteringar.
Använd filväljaren eller hanterad lagring när det är möjligt
För vanliga appar är det säkraste aktuella arbetsflödet att välja en riktig mapp på det avsedda ZimaOS-lagringsutrymmet i appens volyminställningar, välja eller behålla den containersökväg som appen förväntar sig, spara och sedan använda den containersökvägen i applikationen.
Använd inte en rå enhetsnod som applikationsmapp
Källskärmbilden innehåller en sökväg som börjar med /dev/... i en experimentell volymmappning. En blockenhetsnod är inte samma sak som en monterad filsystemskatalog. Vanliga applikationer som Syncthing och Immich bör få en monterad mapp, inte en omonterad rå diskenhet.
/DATA är en ZimaOS-datapats, inte en platshållare för varje disk
En senare nybörjare frågade om /DATA betyder helt enkelt ”starta varje sökväg här”. Det gör den inte. /DATA är en hanterad ZimaOS-dataplats som används för systemhanterad applikations- och användardata. Separat extern lagring kan visas under /media eller en annan hanterad lagringssökväg beroende på hur ZimaOS registrerade den.
Den viktiga regeln är att välja den faktiska mappen på värden från det avsedda lagringsutrymmet och sedan mappa den till en stabil containersökväg.
Handledaren sa senare att nyare ZimaOS gör detta enklare
I augusti 2026 återkom den ursprungliga författaren och berättade för en annan nybörjare att nyare ZimaOS-versioner förenklar arbetsflödet. Den senare kommentaren förstärker den historiska avgränsningen: använd terminalskärmbilderna från 2025 för att förstå sökvägar på värd- respektive containersidan, inte som ett krav på att manuellt hitta varje aktuell monteringspunkt.
Vanliga frågor om åtkomst till externa enheter
Vilken sida av en Docker-volym är den riktiga disksökvägen?
Värdsidan.
Vilken sökväg ska Immich, Syncthing eller en annan app använda internt?
Sökvägen på containersidan som konfigurerats i volymmappningen.
Ska varje app pekas direkt mot /mnt eller en enhetsnod?
Nej. Föredra stabila, hanterade lagringssökvägar när ZimaOS tillhandahåller sådana.
Var sa IceWhale att externa medier monteras som standard?
Zima-Giorgio sa att extern lagringsmedia finns under /media som standard.
