Community Solution

qBittorrent on ZimaOS: Use the Correct Download Folder

A user mapped a secondary HDD into qBittorrent but entered the ZimaOS host path inside the app; switching to /downloads fixed it.

The confirmed fix in this thread was to set qBittorrent’s Default Save Path to the Docker container path /downloads, not the ZimaOS host path. The user had already mounted the secondary HDD correctly; qBittorrent was simply being told to save to a path that only the host understood.

Changing PUID/PGID to root did not solve the source case. Once the path was corrected, the original author explicitly confirmed that downloads worked.

What the Original Mapping Looked Like

ZimaOS Files showing a Downloads folder on the GERAL hard drive
The user wanted qBittorrent downloads to land in the Downloads folder on the secondary GERAL drive. Source: IceWhale Community Forum.
ZimaOS storage view showing GERAL as a separate 2TB hard drive
ZimaOS already recognized GERAL as a separate 2TB HDD, so drive detection was not the problem. Source: IceWhale Community Forum.
qBittorrent Docker volume mapping from GERAL Downloads to /downloads
The app mapping correctly exposed the host folder to qBittorrent as the container path /downloads. Source: IceWhale Community Forum.

The important mapping is conceptually:

Host: /media/GERAL/Downloads → Container: /downloads

ZimaOS sees the left side. qBittorrent runs inside Docker and should normally use the right side.

The Wrong Path Was Inside qBittorrent

qBittorrent Default Save Path incorrectly set to the ZimaOS host path
Inside qBittorrent, the user entered the host-side /media path instead of the mounted container path. Source: IceWhale Community Forum.

The qBittorrent WebUI was configured with /media/GERAL/Downloads. That host path was not the path exposed to the application inside the container.

The current qBittorrent folder guide documents the same source case and verified resolution.

Why Root PUID and PGID Did Not Help

Permissions and path visibility are different problems. Running as root cannot make an unmounted host path magically appear inside a container. First verify the container path; only investigate ownership when the correct mapped path returns Permission denied.

The adjacent qBittorrent permission guide covers that second failure mode.

Current Docker Images Use the Same Pattern

The current LinuxServer qBittorrent image documents a downloads volume mounted to /downloads. See the LinuxServer qBittorrent docs before changing a customized app definition.

Bottom Line

If ZimaOS already maps your target disk into qBittorrent as /downloads, use /downloads or a subfolder below it inside qBittorrent. Do not paste the ZimaOS host path into the application unless that exact path is also mounted into the container.