Solución de la comunidad

Permiso denegado en qBittorrent en ZimaOS: corrige las rutas de descarga sin usar chmod 777

A January 2026 thread where qBittorrent could see a mapped media folder but every download failed with Permission Denied. The community created a dedicated download subfolder and applied broad write permissions; the original poster confirmed it worked. The permanent lesson is path mapping plus correct ownership/permissions, not chmod 777 itself.

El problema de qBittorrent de origen tenía dos capas. Primero, qBittorrent debe guardar en una ruta que exista dentro del contenedor. Segundo, el proceso de qBittorrent debe tener permiso de escritura en la carpeta del host que está detrás de esa ruta del contenedor. El usuario ya había resuelto la capa de asignación: la carpeta era visible, pero el registro de ejecución aún mostraba Permiso denegado.

La solución de la comunidad creó una carpeta de descargas dedicada y utilizó una configuración muy amplia chmod -R 777 como prueba rápida de permisos. El autor original confirmó que las descargas funcionaron después. Ese resultado demuestra que el fallo era un problema de permisos de escritura, pero 777 no debería ser la recomendación permanente en un sistema actual.

La ruta del host y la ruta de qBittorrent son nombres diferentes para el mismo almacenamiento

La configuración de almacenamiento de qBittorrent en ZimaOS asignó una carpeta Movies del host a la ruta del contenedor /Movies-TV
La asignación de origen expuso la carpeta Movies del host dentro de qBittorrent como /Movies-TV.

La fuente utilizó:

  • Host: /media/Main Storage/Media/Movies
  • Contenedor: /Movies-TV

Dentro de qBittorrent, la ruta de guardado debe utilizar /Movies-TV/..., no la ruta sin procesar del host.

La visibilidad demostró que la asignación funcionaba; el permiso denegado demostró que no se podía escribir

El registro de ejecución de qBittorrent del usuario indicaba Permiso denegado. Eso es diferente de Archivo o directorio inexistente:

  • Archivo o directorio inexistente: probablemente la asignación o la ruta sea incorrecta.
  • Permiso denegado: el contenedor puede acceder a la ruta, pero no puede escribir en ella.

Una carpeta de descargas dedicada facilita la configuración correcta de los permisos

La comunidad creó una subcarpeta como:

/media/Main Storage/Media/Movies/qbittorrent-downloads

y estableció el destino dentro del contenedor de qBittorrent como:

/Movies-TV/qbittorrent-downloads

Esto es mejor que conceder a un descargador acceso de escritura a todo un árbol multimedia si solo necesita un directorio de preparación.

chmod 777 fue un atajo de diagnóstico, no un buen modelo de permisos definitivo

La respuesta de la comunidad utilizó chmod 777 de forma recursiva chmod 777 y el autor original confirmó que solucionó el problema. Eso establece la causalidad, pero los permisos de escritura para todos permiten que cualquier identidad de proceso local escriba en el directorio.

Una solución permanente más segura consiste en identificar el UID/GID de ejecución del contenedor de qBittorrent y conceder únicamente a ese usuario/grupo el acceso de escritura necesario.

Comprueba el propietario antes de cambiarlo

Entre las comprobaciones útiles de solo lectura se incluyen inspeccionar el propietario/grupo y el modo de la carpeta antes de modificar nada. Si qBittorrent se ejecuta con un PUID/PGID configurable, alinea esos valores con un grupo del host que tenga permisos de escritura en el directorio de descargas.

Evita cambiar recursivamente el propietario de toda una biblioteca multimedia compartida cuando solo una carpeta necesita permisos de escritura.

ZimaOS actual hace explícitas las rutas de los volúmenes de las aplicaciones

La documentación actual de IceWhale explica que las aplicaciones de la tienda de aplicaciones se ejecutan dentro de contenedores y que sus carpetas importantes están asignadas a almacenamiento real del host. Estas asignaciones pueden consultarse y editarse desde la configuración de la aplicación.

Usa el modelo de rutas Docker actual de ZimaOS antes de editar los permisos.

Separa la carpeta de almacenamiento temporal de descargas de la biblioteca multimedia final

Una arquitectura común es:

  • qBittorrent escribe en una carpeta de descargas dedicada;
  • Sonarr/Radarr u otro organizador importa los archivos completados;
  • Jellyfin/Plex lee la biblioteca multimedia final, normalmente en modo de solo lectura.

Esto proporciona a cada aplicación únicamente el acceso que necesita.

Prueba primero con una sola descarga pequeña

Después de cambiar la asignación o los permisos:

  1. reinicia qBittorrent;
  2. confirma que la ruta de guardado se resuelva dentro del contenedor;
  3. descarga un archivo de prueba pequeño y legal;
  4. comprueba el registro de ejecución;
  5. verifica que el archivo aparezca en el almacenamiento del host previsto.

Preguntas frecuentes sobre la ruta de descarga de qBittorrent

¿La propia asignación del volumen de origen era incorrecta?

La comunidad concluyó que era visible/correcto; el error restante era de permisos de escritura.

¿chmod 777 permitió que funcionara el caso de origen?

Sí, y el autor de la publicación original confirmó que funcionó. Debe considerarse un atajo de diagnóstico general, no el permiso permanente recomendado.

¿Qué ruta debe usar qBittorrent internamente?

La ruta del lado del contenedor definida en la asignación de volúmenes de ZimaOS, como /Movies-TV/qbittorrent-downloads.