Community-Lösung

Lege den richtigen qBittorrent-Downloadordner auf ZimaOS fest

A ZimaOS user mapped qBittorrent downloads to a second drive but kept entering the ZimaOS host path inside qBittorrent. The confirmed fix was to use the Docker container path /downloads instead.

Wenn qBittorrent Downloads weiterhin auf dem ZimaOS-Systemlaufwerk speichert, obwohl du in den App-Einstellungen eine andere HDD ausgewählt hast, überprüfe, welchen Pfad du direkt in qBittorrent eingegeben hast. Im IceWhale-Community-Thread vom November 2025 war das sekundäre Laufwerk bereits in den qBittorrent-Container eingebunden, aber der Nutzer hatte den ZimaOS-Host-Pfad anstelle des Docker-Container-Pfads eingegeben.

Die bestätigte Lösung war einfach: Verwende /downloads in qBittorrent, nicht den ZimaOS-Host-Pfad wie /media/GERAL/downloads. Die Änderung von PUID/PGID zu 0/0 behob den ursprünglichen Fall nicht; die Korrektur des Pfads hingegen schon, und der ursprüngliche Autor bestätigte ausdrücklich, dass die Downloads danach funktionierten.

Der entscheidende Unterschied: Host-Pfad und Container-Pfad

Eine Docker-Volume-Zuordnung besteht aus zwei Seiten:

HOST_PATH:CONTAINER_PATH

Zum Beispiel:

/media/GERAL/downloads:/downloads

ZimaOS sieht die linke Seite. qBittorrent läuft innerhalb des Containers und sollte normalerweise die rechte Seite verwenden.

Richtig in qBittorrent: /downloads
Falsch in qBittorrent:   /media/GERAL/downloads

Was der ursprüngliche Nutzer konfiguriert hatte

ZimaOS-qBittorrent-Einstellungen mit der Download-Zuordnung zum sekundären GERAL-Laufwerk
Der ursprüngliche Beitrag zeigt, dass qBittorrent mit Speicherplatz auf dem sekundären GERAL-Laufwerk konfiguriert war.
qBittorrent-Download-Einstellungen mit einem ZimaOS-Host-Pfad anstelle des Docker-Pfads
In der qBittorrent-Einstellung wurde ein Host-Pfad anstelle des eingebundenen Container-Pfads verwendet.
ZimaOS-Speicherpfad für das GERAL-Laufwerk, das für den qBittorrent-Container verwendet wird
ZimaOS zeigt den physischen Host-Pfad an, aber qBittorrent muss diese Pfadangabe intern nicht ebenfalls verwenden.
Feld für den qBittorrent-Download-Ordner aus dem ZimaOS-Fehlerbehebungs-Thread
Die bestätigte Lösung bestand darin, den eingebundenen Container-Pfad zu verwenden /downloads.

Warum die Änderung von PUID und PGID diesen Fall nicht behoben hat

Eine Community-Antwort schlug zunächst vor, verschiedene Varianten zu testen PUID/PGID Werte, einschließlich 0/0. Der ursprüngliche Autor hat das versucht und berichtet, dass es nicht funktioniert hat.

Das ist wichtig, weil es diesen Fall von einem Berechtigungsproblem abgrenzt. Root-Berechtigungen machen aus einem nicht eingebundenen Hostpfad nicht den korrekten Containerpfad.

Aktuelles LinuxServer-qBittorrent verwendet dasselbe Muster

Die aktuelle Docker-Dokumentation von LinuxServer zu qBittorrent verwendet:

/path/to/downloads:/downloads

und definiert /downloads als Downloadspeicherort innerhalb des Containers. Das entspricht exakt der Lösung aus der Community.

Docker-Dokumentation von LinuxServer zu qBittorrent

So behebst du den Downloadordner

  1. Öffne die qBittorrent-App-Einstellungen in ZimaOS.
  2. Finde die Zuordnung des Download-Volumes.
  3. Bestätige, dass sich der gewünschte Ordner auf dem sekundären Laufwerk auf der Host-Seite von ZimaOS befindet.
  4. Bestätige, dass die Container-Seite einen stabilen Pfad wie diesen verwendet: /downloads.
  5. Speichere die Änderungen und starte die App neu, wenn sich die Docker-Zuordnung geändert hat.
  6. Öffne die qBittorrent-WebUI.
  7. Gehe zu Werkzeuge → Optionen → Downloads.
  8. Lege den Standard-Speicherpfad auf /downloads oder einen Unterordner wie /downloads/complete.
  9. Starte einen kleinen Test-Torrent und überprüfe, auf welchem physischen Laufwerk die Daten gespeichert werden.

Wann PUID-/PGID-Berechtigungen tatsächlich eine Rolle spielen

Falls /downloads ist korrekt, aber in den qBittorrent-Protokollen steht Zugriff verweigertund überprüfe anschließend Eigentümer und Berechtigungen. Das Image von LinuxServer unterstützt PUID und PGID speziell für Berechtigungen von Host-Bind-Mounts.

Das ist ein anderer Fehler als im Ausgangsthread. Überprüfe zuerst die Pfadkorrektheit und erst danach die Berechtigungen.

FAQ zum qBittorrent-Downloadordner unter ZimaOS

Warum verwendet qBittorrent weiterhin das Systemlaufwerk von ZimaOS?

Im Ausgangsfall war qBittorrent mit dem Hostpfad statt mit dem eingebundenen Containerpfad konfiguriert.

Welcher Pfad hat den ursprünglichen Thread gelöst?

/downloads. Der Autor bestätigte, dass es funktioniert hat.

Soll ich PUID und PGID auf 0 setzen?

Nicht für dieses Problem. Der ursprüngliche Autor hat das erfolglos versucht. Verwende zuerst den korrekten Containerpfad.