Wenn qBittorrent einen Ordner in ZimaOS sehen kann, aber jeder Torrent sofort fehlschlägt, reicht es nicht aus, nur den Downloadpfad in qBittorrent zu ändern. Der Hostordner muss zunächst in den Docker-Container eingebunden werden, und der Benutzer, unter dem qBittorrent im Container ausgeführt wird, muss Schreibberechtigung für das eingebundene Hostverzeichnis besitzen.
Genau das geschah im Januar-2026-Thread der IceWhale Community. Der ursprüngliche Verfasser ordnete einen Medienordner /Movies-TV zu, aber im Ausführungsprotokoll von qBittorrent wurde Permission denied angezeigt. Ein eigener Unterordner sowie Schreibberechtigungen auf dem Host behoben das ursprüngliche Problem. Die Community verwendete chmod -R 777 als schnelle Lösung, doch die aktuelle Anleitung von LinuxServer empfiehlt, PUID/PGID an die Besitzverhältnisse auf dem Host anzupassen, statt das Verzeichnis für alle Benutzer beschreibbar zu machen.
Hostpfad vs. Containerpfad
Ein ZimaOS-Pfad ist innerhalb von qBittorrent nicht automatisch sichtbar. Eine übliche Zuordnung sieht so aus:
Host: /DATA/Downloads
Container: /downloadsAnschließend sollte qBittorrent in einem Containerpfad wie /downloads/qbittorrent speichern.
Die ursprüngliche Zuordnung
Host: /media/Main Storage/Media/Movies
Container: /Movies-TV
Einen eigenen Downloadordner erstellen
Die in der Community funktionierende Struktur enthielt:
/media/Main Storage/Media/Movies/qbittorrent-downloadsund wurde in qBittorrent so verwendet:
/Movies-TV/qbittorrent-downloadsBerechtigungen prüfen
ls -ld "/media/Main Storage/Media/Movies"
ls -ld "/media/Main Storage/Media/Movies/qbittorrent-downloads"Wenn das Verzeichnis existiert, das Protokoll jedoch Permission denied meldet, hat die Identität des Containers keinen Schreibzugriff.
Die von der Community bestätigte schnelle Lösung
chmod -R 777 "/media/Main Storage/Media/Movies/qbittorrent-downloads"Der ursprüngliche Verfasser bestätigte, dass dies funktionierte. 777 gewährt jedoch weitreichende Lese-, Schreib- und Ausführungsrechte. Verwende den Befehl daher eher zur Diagnose oder vorübergehend und nicht als ideale dauerhafte Berechtigungslösung.
Bevorzugte dauerhafte Lösung: PUID und PGID anpassen
Das aktuelle LinuxServer-qBittorrent-Image unterstützt PUID und PGID ausdrücklich, um Berechtigungskonflikte bei Bind-Mounts zu vermeiden. In der Dokumentation wird empfohlen, den Besitz des Hostverzeichnisses mit den an den Container übergebenen IDs kompatibel zu machen.
LinuxServer-Dokumentation zu qBittorrent
PUID=1000
PGID=1000Diese Werte dienen nur als Beispiele. Prüfe das vorgesehene Hostkonto mit id USERNAME und verwende die tatsächlichen IDs oder eine passende gemeinsame Gruppe.
Neustarten und testen
- Speichere die Volume-Zuordnung.
- Starte qBittorrent neu oder erstelle den Container neu.
- Lege den Standard-Speicherpfad auf den zugeordneten Containerpfad fest.
- Starte einen kleinen Testdownload.
- Wenn der Download weiterhin fehlschlägt, prüfe Tools → Ausführungsprotokoll.
Was die Fehler bedeuten
- Permission denied: Der Pfad existiert, ist aber nicht beschreibbar.
- No such file or directory: Der Containerpfad fehlt oder wurde falsch zugeordnet.
FAQ zum qBittorrent-Downloadpfad
Sollte qBittorrent den ZimaOS-Hostpfad verwenden?
Nein. Normalerweise sollte qBittorrent den Containerpfad verwenden, der in der Volume-Zuordnung definiert ist.
Hat chmod 777 das Problem im ursprünglichen Thread gelöst?
Ja. Der Verfasser bestätigte, dass es funktionierte. Langfristig sind jedoch gezieltere PUID/PGID- oder Gruppenberechtigungen sicherer.
Warum kann qBittorrent einen Ordner sehen, aber nicht darin schreiben?
Die Sichtbarkeit eines Docker-Mounts und die Schreibberechtigung im Dateisystem sind voneinander getrennt. Ein eingebundener Ordner kann für den Containerbenutzer lesbar, aber nicht beschreibbar sein.
