El error La carpeta '/tv/' no permite escritura al usuario 'abc'. esto significa que Sonarr puede ver el directorio montado, pero el proceso que se ejecuta dentro del contenedor no tiene permiso para escribir en él. El mismo problema puede aparecer en Radarr como un error de carpeta raíz de películas.
En el caso de la comunidad de IceWhale de julio de 2025, ambas aplicaciones procedían de la tienda de aplicaciones de ZimaOS y utilizaban los valores predeterminados PUID=1000 PUID PGID=1000. Las carpetas multimedia del usuario se encontraban en un grupo de almacenamiento RAID. Un miembro del equipo de IceWhale sugirió establecer ambos identificadores en 0, y el autor original confirmó que esto hizo que las carpetas permitieran la escritura. Sin embargo, ejecutar la aplicación con identificadores equivalentes a los de root concede un acceso mucho más amplio al sistema de archivos del necesario normalmente. La documentación actual de LinuxServer.io recomienda hacer coincidir PUID/PGID con el propietario o grupo de los directorios del host.
Qué significa «La carpeta no permite escribir al usuario abc»
El paquete de la tienda de aplicaciones de ZimaOS mencionado en el hilo utilizaba contenedores de Sonarr y Radarr con el estilo de LinuxServer. Estas imágenes ejecutan el proceso de la aplicación como un usuario interno que normalmente se muestra como abc, mientras que Comprueba el PUID y asigna ese proceso interno a identificadores numéricos de usuario y grupo en el sistema de archivos del host.
Si el directorio del host pertenece a un UID/GID diferente y sus bits de permisos no permiten que el proceso asignado escriba, Sonarr o Radarr pueden explorar el montaje, pero no pueden crear, cambiar de nombre, mover ni importar archivos multimedia allí.
Las asignaciones originales de la tienda de aplicaciones de ZimaOS
La publicación incluía capturas de pantalla de configuración independientes para Radarr y Sonarr. Las aplicaciones podían ver los volúmenes del host configurados, pero la creación de carpetas raíz fallaba dentro de las aplicaciones.
Los errores de Sonarr y Radarr
Sonarr devolvió:
No se pudo añadir la carpeta raíz.
La carpeta '/tv/' no permite escritura al usuario 'abc'.
Radarr mostró el problema correspondiente con la ruta de películas:
La solución de la comunidad: PUID=0 y PGID=0
Un miembro del equipo de IceWhale respondió:
PUID=0
PGID=0El autor original cambió ambos valores a cero e informó que el problema parecía resuelto. Por lo tanto, esta es la solución confirmada para esa configuración específica de la App Store de ZimaOS de julio de 2025.
Sin embargo, UID 0 y GID 0 son identidades de nivel root en Linux. Ejecutar Sonarr o Radarr con esos identificadores puede permitir que la aplicación escriba en ubicaciones muy alejadas de la biblioteca multimedia prevista si esas rutas están montadas en el contenedor. Usa esto solo como solución de diagnóstico o compatibilidad cuando comprendas el acceso que concede.
Solución preferida: hacer coincidir PUID y PGID con el propietario del almacenamiento del host
La documentación actual de Sonarr y Radarr de LinuxServer.io explica el diseño previsto: establece Comprueba el PUID y a un usuario o grupo del host que ya sea propietario del volumen asignado o tenga permiso de escritura en él.
Las indicaciones de LinuxServer señalan que los problemas de permisos surgen cuando un volumen del host pertenece a identificadores que no coinciden con los proporcionados al contenedor. Su patrón recomendado es:
PUID=1000
PGID=1000solo cuando UID 1000 y GID 1000 sean realmente adecuados para las rutas multimedia. El número 1000 no es inherentemente correcto; simplemente es un ID de usuario de Linux no root común como primera opción.
Consulta la documentación de Sonarr de LinuxServer actual y la documentación de Radarr de LinuxServer actual.
Cómo inspeccionar el propietario y los permisos del almacenamiento
Si la interfaz de archivos de ZimaOS no muestra los valores numéricos de propietario y grupo de Linux que necesitas, inspecciona la ruta real del host desde un terminal autorizado.
Primero identifica el directorio real del host asignado a /tv o /moviesDespués, inspecciónala:
ls -ldn /REAL/HOST/PATH
stat /REAL/HOST/PATHLa salida numérica te ayuda a determinar qué UID y GID son actualmente propietarios del directorio. No ejecutes estos comandos contra la ruta exclusiva del contenedor. /tv desde el host, a menos que esa sea realmente la ruta del host.
Si la cuenta de administración de medios que quieres utilizar está disponible en el host, puedes consultar sus identificadores con:
id USERNAMEDespués, establece el Sonarr/Radarr Comprueba el PUID y a los identificadores que correspondan al modelo de acceso que hayas elegido deliberadamente.
No ejecutes chown a ciegas sobre /tv dentro del contenedor
Otra respuesta de la comunidad sugirió:
sudo chown abc:abc /tv/Ese consejo es arriesgado si se copia sin contexto. La propiedad de un directorio montado mediante bind se representa en última instancia mediante identificadores numéricos en el host. El nombre abc existe dentro de los contenedores de LinuxServer y puede no existir como una cuenta de host significativa. Cambiar la propiedad de forma recursiva también puede afectar inesperadamente a toda una biblioteca multimedia.
Antes de usar chown, confirma:
- la ruta exacta del host que se está modificando;
- el UID y GID deseados en el host;
- si otros servicios, como qBittorrent, SABnzbd, Jellyfin o usuarios de SMB, necesitan acceder a los mismos archivos;
- si un grupo compartido sería más apropiado que cambiar la propiedad.
Haz copias de seguridad de la configuración importante y evita cambiar permisos de forma recursiva hasta comprender sus efectos.
Planifica los permisos de los medios compartidos en toda la pila ARR
Sonarr y Radarr rara vez funcionan de forma aislada. Primero, un cliente de descargas crea los archivos; después, Sonarr o Radarr los importa, y Jellyfin puede leer el resultado. Si cada contenedor utiliza identificadores y montajes no relacionados, una aplicación puede crear archivos que otra no pueda modificar.
Un diseño más limpio consiste en dar a las aplicaciones un grupo común o una asignación de PUID/PGID compatible para el conjunto de datos compartido. LinuxServer también recomienda planificar bien las rutas de los volúmenes para que los clientes de descarga y las aplicaciones ARR puedan usar enlaces duros o movimientos atómicos cuando corresponda.
Por ejemplo, en lugar de tratar las descargas y los medios como montajes aislados y sin relación, un único árbol de datos compartido en el host puede facilitar el razonamiento sobre los permisos y la coherencia de las rutas:
/data
├── descargas
├── medios
│ ├── películas
│ └── tvLa ruta exacta de ZimaOS depende de tu grupo de almacenamiento y no debe copiarse a ciegas.
¿Cuándo es útil la solución alternativa con identificadores de root?
Establecer PUID/PGID en 0 puede ser útil como diagnóstico breve:
- Si el error desaparece de inmediato, es probable que el montaje del contenedor sea correcto.
- El problema restante probablemente se deba entonces a la propiedad o la asignación de permisos en el host.
Una vez confirmado, el objetivo más seguro a largo plazo es otorgar al contenedor únicamente los permisos necesarios para sus rutas de medios y descargas. Si el modelo exacto de almacenamiento de ZimaOS hace que una asignación sin root no sea práctica, documenta por qué se requieren identificadores de root y limita cuidadosamente los directorios montados.
Restart the Apps After Changing PUID or PGID
Reinicia las aplicaciones después de cambiar PUID o PGID
- PUID y PGID se aplican cuando se inicia el contenedor. Después de cambiarlos en ZimaOS:
- Guarda la configuración de la aplicación.
- Reinicia o recrea el contenedor de Sonarr/Radarr mediante ZimaOS.
- Vuelve a abrir la configuración de la carpeta raíz.
Prueba a crear o seleccionar la carpeta montada.
Si la carpeta sigue sin permitir escrituras, compara la propiedad numérica y el modo del directorio del host con los ID que utiliza ahora el contenedor.
- Lista de comprobación de permisos de Sonarr/Radarr en ZimaOS
- Confirma que la ruta multimedia del host esté montada en Sonarr o Radarr.
- Confirma que la ruta del contenedor sea la que se selecciona dentro de la aplicación.
- Inspecciona el UID, el GID y los bits de permisos de la ruta del host.
Comprueba elPUIDyPGID - en la configuración de la aplicación de ZimaOS.
- Da preferencia a los ID que coincidan con el propietario/grupo previsto del host.
- Reinicia el contenedor después de cambiar los ID.
- Usa PUID/PGID 0 únicamente si comprendes el acceso de nivel root que concede.
Evita los cambios recursivos amplioso un chmod 777chownsoluciones. - Asegúrate de que los clientes de descargas y los servidores multimedia utilicen un modelo compatible de permisos compartidos.
Preguntas frecuentes sobre los permisos de Sonarr y Radarr
¿Quién es el usuario abc?
abc abc es el nombre del usuario de servicio interno que suelen utilizar los contenedores de LinuxServer.io. PUID y PGID determinan qué identidad numérica del host utiliza ese proceso para acceder a los volúmenes montados.
¿Por qué fallan PUID=1000 y PGID=1000?
Esos valores solo funcionan cuando UID/GID 1000 tienen el acceso necesario al directorio multimedia del host. Si el directorio RAID de ZimaOS pertenece a otro usuario o grupo, el contenedor podría verlo, pero no escribir en él.
¿PUID=0 y PGID=0 solucionan el problema?
Solucionó el caso original de la comunidad, según confirmó su autor. También concede un acceso equivalente al de root dentro del sistema de archivos montado, por lo que no debería ser automáticamente la configuración permanente preferida.
¿Debo hacer chmod 777 en la carpeta multimedia?
No como solución predeterminada. Los permisos de escritura para todos son innecesariamente amplios y pueden ocultar el desajuste real de propietarios. En su lugar, configura deliberadamente la identidad del contenedor y los permisos del grupo compartido.
¿Sonarr, Radarr y el cliente de descargas deben usar el mismo PUID/PGID?
No siempre necesitan ID de usuario idénticos, pero sí un modelo compatible de propietario/grupo para cualquier archivo y carpeta que compartan. Usar un grupo compartido coherente es una forma habitual de evitar fallos al importar y cambiar nombres.
