Community-Lösung

ZimaOS-Apps Zugriff auf externe Laufwerke gewähren: Host-Pfade, Container-Pfade und aktuelle Speicherzuordnung

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.

Dieses Einsteiger-Tutorial löste eine echte Ursache für Verwirrung: Der in den ZimaOS-Dateien angezeigte Name und Pfad ist nicht automatisch der Pfad, den eine Anwendung innerhalb ihres Docker-Containers sieht. Der ursprüngliche Verfasser verwendete das Webterminal, um die Mount-Punkte der Datenträger zu überprüfen, und bildete anschließend den Hostspeicherordner in Immich oder Syncthing auf einen einfacheren Containerpfad wie /SYNC.

Der Thread erhielt später eine wichtige Korrektur: Rohe Mount-Pfade sollten nicht als bevorzugte langfristige Schnittstelle für App-Speicher behandelt werden, wenn ZimaOS einen verwalteten Speicherpfad bereitstellen kann. Das aktuelle ZimaOS macht dies deutlich einfacher als der Ablauf von 2025.

Das ursprüngliche Tutorial begann im Entwicklermodus

ZimaOS-Einstellungsbildschirm mit sichtbarem Entwicklermodus und Webterminal
Das ursprüngliche Tutorial nutzte das integrierte Webterminal, um herauszufinden, wo die Speichergeräte eingebunden waren.

Der Benutzer verwendete lsblk, um Mount-Punkte zu überprüfen

ZimaOS-Terminal mit einer lsblk-Ausgabe, in der die Speicher-Mount-Punkte hervorgehoben sind
Das wichtige Feld war der Mount-Punkt, doch spätere Antworten warnten davor, jeden rohen Mount-Pfad als stabiles Ziel für App-Speicher zu behandeln.

Öffne die App-Einstellungen und füge ein Volume hinzu

ZimaOS-App-Menü mit ausgewählter Option „Konfiguration“
Im Konfigurationsbereich der App wird der Hostspeicher für den Container bereitgestellt.

Die Spalten „Host“ und „Container“ haben unterschiedliche Bedeutungen

Syncthing-Volume-Einstellungen mit einem ZimaOS-Hostspeicherpfad, der innerhalb des Containers auf /SYNC abgebildet wird
Die linke Seite ist der tatsächliche ZimaOS-Hostpfad; die rechte Seite ist der Pfad, den die Anwendung innerhalb ihres Containers sieht.

Wenn der Container-Pfad /SYNC, sollte die Anwendung /SYNC oder einem Unterordner wie /SYNC/Photos. Es sollte nicht wieder auf den Mount-Pfad des Hosts verweisen.

Syncthing-Ordner-Einstellungen mit /SYNC als internem Ordnerpfad
Sobald das Volume zugeordnet ist, funktioniert die Anwendung nur mit dem Pfad innerhalb des Containers.

Eine Antwort aus der Community warnte vor rohen /mnt-Pfaden

Ein anderer Teilnehmer wies darauf hin, dass sich direkte rohe Mount-Pfade nach einer Datenträgeraktualisierung, dem Wiederaufbau eines Pools oder anderen Speichervorgängen ändern können und möglicherweise Annahmen der ZimaOS-Speicherschicht umgehen.

Die Antwort empfahl, stabiles, von ZimaOS verwaltetes Speichern zuzuordnen, etwa /DATA/Media oder dem vorgesehenen AppData-Speicherort, statt eine App um eine beliebige rohe Mount-Kennung herum aufzubauen.

IceWhale stellte klar, dass sich externe Medien standardmäßig unter /media befinden

Zima-Giorgio fügte hinzu, dass Pfade für externe Speichermedien standardmäßig unter /media standardmäßig. Dieser offizielle Hinweis hilft dabei, externen Speicher von den Beispielen für interne Anwendungsdaten unter /DATA.

Aktuelle ZimaOS-Versionen machen das Pfadmodell eindeutiger

Bis August 2026 erklärte der ursprüngliche Tutorial-Autor einem späteren Nutzer, dass neuere ZimaOS-Versionen diesen Vorgang deutlich erleichtern.

Die aktuellen Hinweise von IceWhale erklären wie Host-Speicher und Containerpfade von ZimaOS in den App-Einstellungen zugeordnet werden. Beginne damit, bevor du Pfade manuell aus Ausgaben auf niedriger Einhängeebene erstellst.

Verwende die Dateiauswahl oder verwalteten Speicher, sofern verfügbar

Für normale Apps besteht der derzeit sicherste Ablauf darin, in den Volume-Einstellungen der App einen echten Ordner im vorgesehenen ZimaOS-Speicherbereich auszuwählen, den von der App erwarteten Containerpfad auszuwählen oder beizubehalten, zu speichern und anschließend diesen Containerpfad innerhalb der Anwendung zu verwenden.

Verwende keinen unformatierten Geräteknoten als Anwendungsordner

Der Quell-Screenshot enthält einen Pfad, der mit /dev/... in einer experimentellen Volume-Zuordnung. Ein Blockgeräteknoten ist nicht dasselbe wie ein eingehängtes Dateisystemverzeichnis. Normale Anwendungen wie Syncthing und Immich sollten einen eingehängten Ordner erhalten, kein nicht eingehängtes unformatiertes Datenträgergerät.

/DATA ist ein ZimaOS-Datenspeicherort und kein Platzhalter für jeden Datenträger

Ein späterer Anfänger fragte, ob /DATA bedeutet lediglich „starte jeden Pfad hier“. Das tut es nicht. /DATA ist ein verwalteter ZimaOS-Datenspeicherort für systemverwaltete Anwendungs- und Benutzerdaten. Separater externer Speicher kann unter /media oder einen anderen verwalteten Speicherpfad, je nachdem, wie ZimaOS ihn registriert hat.

Die wichtige Regel lautet, den tatsächlichen Host-Ordner aus dem vorgesehenen Speicherbereich auszuwählen und ihn anschließend einem stabilen Containerpfad zuzuordnen.

Der Tutorial-Autor sagte später, dass neuere ZimaOS-Versionen dies erleichtern

Im August 2026 kehrte der ursprüngliche Autor zurück und erklärte einem anderen Anfänger, dass neuere ZimaOS-Versionen den Ablauf vereinfachen. Dieser spätere Kommentar bekräftigt die historische Abgrenzung: Verwende die Terminal-Screenshots aus dem Jahr 2025, um den Unterschied zwischen Host- und Containerpfaden zu verstehen, nicht als Aufforderung, jeden aktuellen Einhängepunkt manuell zu ermitteln.

FAQ zum Zugriff auf externe Laufwerke

Welche Seite eines Docker-Volumes ist der tatsächliche Festplattenpfad?

Die Host-Seite.

Welchen Pfad sollte Immich, Syncthing oder eine andere App intern verwenden?

Der containerseitige Pfad, der in der Volume-Zuordnung konfiguriert ist.

Sollte jede App direkt auf /mnt oder einen Geräteknoten verweisen?

Nein. Bevorzuge stabile, verwaltete Speicherpfade, wenn ZimaOS diese bereitstellt.

Wo sagte IceWhale, dass externe Medien standardmäßig eingehängt werden?

Zima-Giorgio sagte, dass sich externe Speichermedien unter /media standardmäßig.