Solución de la comunidad

Configura la carpeta de descargas correcta de qBittorrent en 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.

Si qBittorrent sigue guardando las descargas en la unidad del sistema de ZimaOS incluso después de seleccionar otro HDD en la configuración de la aplicación, comprueba qué ruta introdujiste dentro del propio qBittorrent. En el hilo de la comunidad de IceWhale de noviembre de 2025, la unidad secundaria ya estaba montada en el contenedor de qBittorrent, pero el usuario introdujo la ruta del host de ZimaOS en lugar de la ruta del contenedor de Docker.

La solución confirmada fue sencilla: usar /downloads dentro de qBittorrent, no la ruta del host de ZimaOS, como /media/GERAL/downloads. Cambiar PUID/PGID a 0/0 no solucionó el caso original; corregir la ruta sí lo hizo, y el autor original confirmó explícitamente que las descargas funcionaron después.

La diferencia clave: ruta del host frente a ruta del contenedor

Una asignación de volumen de Docker tiene dos lados:

RUTA_DEL_HOST:RUTA_DEL_CONTENEDOR

Por ejemplo:

/media/GERAL/downloads:/downloads

ZimaOS ve el lado izquierdo. qBittorrent se ejecuta dentro del contenedor y normalmente debería usar el lado derecho.

Correcto dentro de qBittorrent: /downloads
Incorrecto dentro de qBittorrent:   /media/GERAL/downloads

Lo que había configurado el usuario original

Configuración de qBittorrent en ZimaOS mostrando la asignación de descargas de la unidad secundaria GERAL
La publicación original muestra qBittorrent configurado con el almacenamiento en la unidad secundaria GERAL.
Configuración de descargas de qBittorrent usando una ruta del host de ZimaOS en lugar de la ruta de Docker
La configuración de qBittorrent usaba una ruta del host en lugar de la ruta montada del contenedor.
Ruta de almacenamiento de ZimaOS para la unidad GERAL utilizada por el contenedor de qBittorrent
ZimaOS muestra la ruta física del host, pero qBittorrent no necesita usar internamente esa misma cadena de ruta.
campo de carpeta de descargas de qBittorrent del hilo de solución de problemas de ZimaOS
La solución confirmada fue usar la ruta montada del contenedor /downloads.

Por qué cambiar PUID y PGID no solucionó este caso

Una respuesta de la comunidad sugirió primero probar diferentes PUID/PGID valores, incluido 0/0. El autor original lo intentó y afirmó que no funcionó.

Esto es importante porque diferencia este caso de un problema de permisos. Los privilegios de root no hacen que una ruta del host sin asignar se convierta en la ruta correcta del contenedor.

La versión actual de qBittorrent de LinuxServer utiliza el mismo patrón

La documentación actual de Docker de qBittorrent de LinuxServer utiliza:

/path/to/downloads:/downloads

y define /downloads como ubicación de descargas dentro del contenedor. Eso coincide exactamente con la solución de la comunidad.

Documentación de Docker de qBittorrent de LinuxServer

Cómo solucionar la carpeta de descargas

  1. Abre la configuración de la aplicación qBittorrent en ZimaOS.
  2. Busca la asignación del volumen de descargas.
  3. Confirma que la carpeta deseada de la unidad secundaria esté en el lado del host de ZimaOS.
  4. Confirma que el lado del contenedor sea una ruta estable como /downloads.
  5. Guarda y reinicia la aplicación si cambió la asignación de Docker.
  6. Abre la interfaz web de qBittorrent.
  7. Ve a Herramientas → Opciones → Descargas.
  8. Establece la ruta de guardado predeterminada en /downloads o una subcarpeta como /downloads/complete.
  9. Inicia un torrent de prueba pequeño y verifica qué unidad física recibe los datos.

Cuándo sí importan los permisos de PUID/PGID

Si /downloads es correcto, pero los registros de qBittorrent muestran Permiso denegado; después, comprueba el propietario y los permisos. La imagen de LinuxServer admite PUID y PGID específicamente para los permisos de los montajes enlazados del host.

Ese es un fallo diferente al del hilo original. Diagnostica primero que la ruta sea correcta y después los permisos.

Preguntas frecuentes sobre la carpeta de descargas de qBittorrent en ZimaOS

¿Por qué qBittorrent sigue usando la unidad del sistema de ZimaOS?

En el caso de origen, qBittorrent estaba configurado con la ruta del host en lugar de la ruta montada del contenedor.

¿Qué ruta solucionó el hilo original?

/downloads. El autor confirmó que funcionó.

¿Debería establecer PUID y PGID en 0?

No para este problema. El autor original lo intentó sin éxito. Usa primero la ruta correcta del contenedor.