Communityoplossing

Stel de juiste qBittorrent-downloadmap in op ZimaOS

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.

Als qBittorrent downloads nog steeds opslaat op de ZimaOS-systeemschijf nadat je in de app-instellingen een andere HDD hebt geselecteerd, controleer dan welk pad je in qBittorrent zelf hebt ingevoerd. In de IceWhale Community-discussie van november 2025 was de secundaire schijf al aangekoppeld in de qBittorrent-container, maar de gebruiker had het ZimaOS-hostpad ingevoerd in plaats van het Docker-containerpad.

De bevestigde oplossing was eenvoudig: gebruik /downloads in qBittorrent, niet het ZimaOS-hostpad zoals /media/GERAL/downloads. Het wijzigen van PUID/PGID naar 0/0 heeft de oorspronkelijke situatie niet opgelost; het corrigeren van het pad wel, en de oorspronkelijke auteur bevestigde expliciet dat downloads daarna werkten.

Het belangrijkste verschil: hostpad versus containerpad

Een Docker-volumekoppeling heeft twee kanten:

HOST_PATH:CONTAINER_PATH

Bijvoorbeeld:

/media/GERAL/downloads:/downloads

ZimaOS ziet de linkerkant. qBittorrent draait in de container en hoort normaal gesproken de rechterkant te gebruiken.

Correct in qBittorrent: /downloads
Onjuist in qBittorrent:   /media/GERAL/downloads

Wat de oorspronkelijke gebruiker had geconfigureerd

qBittorrent-instellingen in ZimaOS met de downloadkoppeling naar de secundaire GERAL-schijf
In het oorspronkelijke bericht is qBittorrent geconfigureerd met opslag op de secundaire GERAL-schijf.
qBittorrent-downloadinstellingen die een ZimaOS-hostpad gebruiken in plaats van het Docker-pad
De qBittorrent-instelling gebruikte een pad aan de hostzijde in plaats van het aangekoppelde containerpad.
Het ZimaOS-opslagpad voor de GERAL-schijf die voor de qBittorrent-container wordt gebruikt
ZimaOS stelt het fysieke hostpad beschikbaar, maar qBittorrent hoeft diezelfde padtekenreeks intern niet te gebruiken.
Het downloadmapveld van qBittorrent uit de probleemoplossingsdiscussie van ZimaOS
De bevestigde oplossing was het gebruik van het aangekoppelde containerpad /downloads.

Waarom het wijzigen van PUID en PGID dit geval niet heeft opgelost

Een antwoord uit de community stelde eerst voor om verschillende PUID/PGID waarden, waaronder 0/0. De oorspronkelijke auteur heeft dat geprobeerd en gemeld dat het niet werkte.

Dat is belangrijk, omdat dit geval daarmee wordt onderscheiden van een machtigingsprobleem. Rootrechten zorgen er niet voor dat een niet-gemapte hostpad het juiste containerpad wordt.

De huidige qBittorrent-image van LinuxServer gebruikt hetzelfde patroon

De huidige Docker-documentatie voor qBittorrent van LinuxServer gebruikt:

/path/to/downloads:/downloads

en definieert /downloads als downloadlocatie binnen de container. Dat komt precies overeen met de oplossing uit de community.

Docker-documentatie voor qBittorrent van LinuxServer

De downloadmap repareren

  1. Open de qBittorrent-appinstellingen in ZimaOS.
  2. Zoek de volumekoppeling voor downloads.
  3. Controleer of de gewenste map op de secundaire schijf zich aan de hostzijde van ZimaOS bevindt.
  4. Controleer of de containerzijde een stabiel pad gebruikt, zoals /downloads.
  5. Sla de wijzigingen op en start de app opnieuw als de Docker-koppeling is gewijzigd.
  6. Open de qBittorrent-webinterface.
  7. Ga naar Extra → Opties → Downloads.
  8. Stel het standaardopslagpad in op /downloads of een submap zoals /downloads/complete.
  9. Start een kleine testtorrent en controleer op welke fysieke schijf de gegevens worden opgeslagen.

Wanneer PUID/PGID-machtigingen er wel toe doen

Als /downloads is correct, maar in de qBittorrent-logboeken staat Toegang geweigerden controleer vervolgens het eigendom en de machtigingen. De image van LinuxServer ondersteunt PUID en PGID specifiek voor machtigingen van host-bindmounts.

Dat is een andere fout dan in de oorspronkelijke thread. Controleer eerst of het pad correct is en daarna de machtigingen.

Veelgestelde vragen over de downloadmap van qBittorrent op ZimaOS

Waarom gebruikt qBittorrent nog steeds de systeemschijf van ZimaOS?

In het oorspronkelijke geval was qBittorrent geconfigureerd met het hostpad in plaats van het gekoppelde containerpad.

Welk pad loste de oorspronkelijke thread op?

/downloads. De auteur bevestigde dat het werkte.

Moet ik PUID en PGID instellen op 0?

Niet voor dit probleem. De oorspronkelijke auteur heeft dat zonder succes geprobeerd. Gebruik eerst het juiste containerpad.