Si qBittorrent puede ver una carpeta en ZimaOS, pero cada torrent falla de inmediato, no basta con cambiar la ruta de descarga dentro de qBittorrent. Primero hay que montar la carpeta del host en el contenedor de Docker, y el usuario que ejecuta qBittorrent dentro de ese contenedor debe tener permiso para escribir en el directorio montado del host.
Eso fue lo que ocurrió en el hilo de IceWhale Community de enero de 2026. El autor original asignó una carpeta multimedia a /Movies-TV, pero el registro de ejecución de qBittorrent mostraba Permission denied. Una subcarpeta dedicada, junto con permisos de escritura en el host, resolvió el caso original. La comunidad utilizó chmod -R 777 como solución rápida, pero las directrices actuales de LinuxServer recomiendan hacer coincidir PUID/PGID con la propiedad del host, en lugar de dejar el directorio con permisos de escritura para todo el mundo.
Ruta del host frente a ruta del contenedor
Una ruta de ZimaOS no queda visible automáticamente dentro de qBittorrent. Una asignación normal es:
Host: /DATA/Downloads
Container: /downloadsDespués, qBittorrent debería guardar en una ruta del contenedor como /downloads/qbittorrent.
La asignación original
Host: /media/Main Storage/Media/Movies
Container: /Movies-TV
Crear una carpeta de descargas dedicada
La estructura que funcionó en la comunidad creó:
/media/Main Storage/Media/Movies/qbittorrent-downloadsy utilizó esta ruta dentro de qBittorrent:
/Movies-TV/qbittorrent-downloadsComprobar los permisos
ls -ld "/media/Main Storage/Media/Movies"
ls -ld "/media/Main Storage/Media/Movies/qbittorrent-downloads"Si el directorio existe, pero el registro indica Permission denied, la identidad del contenedor no tiene acceso de escritura.
La solución rápida confirmada por la comunidad
chmod -R 777 "/media/Main Storage/Media/Movies/qbittorrent-downloads"El autor original confirmó que funcionó. Sin embargo, 777 concede permisos amplios de lectura, escritura y ejecución, por lo que conviene utilizarlo como diagnóstico o solución temporal, no como modelo de permisos permanente ideal.
Solución preferida a largo plazo: hacer coincidir PUID y PGID
La imagen actual de qBittorrent de LinuxServer admite PUID y PGID específicamente para evitar conflictos de permisos con montajes bind. Su documentación recomienda que la propiedad del directorio del host sea compatible con los identificadores proporcionados al contenedor.
Documentación de qBittorrent de LinuxServer
PUID=1000
PGID=1000Esos valores son solo ejemplos. Comprueba la cuenta del host prevista con id USERNAME y utiliza los identificadores reales o un grupo compartido compatible.
Reiniciar y probar
- Guarda la asignación de volumen.
- Reinicia o vuelve a crear qBittorrent.
- Establece la ruta de guardado predeterminada en la ruta asignada del contenedor.
- Inicia una descarga de prueba pequeña.
- Consulta Herramientas → Registro de ejecución si sigue fallando.
Qué significan los errores
- Permission denied: la ruta existe, pero no permite escritura.
- No such file or directory: falta la ruta del contenedor o está asignada incorrectamente.
Preguntas frecuentes sobre la ruta de descarga de qBittorrent
¿qBittorrent debe utilizar la ruta del host de ZimaOS?
No. Normalmente debe utilizar la ruta del contenedor definida en la asignación de volumen.
¿chmod 777 solucionó el problema del hilo original?
Sí. El autor confirmó que funcionó, pero a largo plazo son más seguros unos permisos más específicos mediante PUID/PGID o grupos.
¿Por qué qBittorrent puede ver una carpeta, pero no escribir en ella?
La visibilidad del montaje de Docker y los permisos de escritura del sistema de archivos son aspectos independientes. Una carpeta asignada puede ser legible, pero no permitir la escritura al usuario del contenedor.
