Solución de la comunidad

Mover los archivos multimedia a otra unidad de ZimaOS sin afectar Jellyfin ni Radarr: actualizar la ruta del volumen de Docker

A September 2025 support thread where a user moved movie folders from ZimaOS-HD to a new NVMe, Radarr saw the new storage but Jellyfin lost the files. Zima-Giorgio showed how to find the real host path and edit the app volume mapping through the GUI. The user immediately confirmed the GUI path picker solved the confusion.

Mover una carpeta multimedia a otra unidad de ZimaOS no actualiza automáticamente todas las aplicaciones Docker que usaban la ruta anterior. Eso es exactamente lo que ocurrió en el caso original: los archivos de películas se movieron a una nueva unidad NVMe, Radarr reflejó la nueva ubicación de almacenamiento, pero Jellyfin seguía haciendo referencia a su antiguo montaje de enlace y ya no podía encontrar la película.

La solución es actualizar la ruta del volumen en el host de la aplicación y mantener una ruta estable dentro del contenedor, como /movies o /media. Zima-Giorgio mostró tanto la búsqueda mediante la CLI como el selector de carpetas de la interfaz gráfica, y el usuario confirmó de inmediato que el método gráfico resolvió el problema.

Configuración de volúmenes de Radarr en ZimaOS, con las rutas del host a la izquierda y las rutas del contenedor, como config, movies, downloads y extra-movies, a la derecha
El origen ya tenía varias asignaciones de volúmenes Docker; mover la carpeta física cambió la ruta del host de la izquierda, no el concepto de ruta interna de Radarr.

Docker tiene una ruta del host y una ruta del contenedor

Una asignación tiene conceptualmente este aspecto:

/ruta/real/en/ZimaOS  →  /ruta/dentro/de/la/aplicación

El lado izquierdo debe apuntar al dispositivo de almacenamiento y la carpeta donde realmente se encuentran los archivos. El lado derecho es lo que Jellyfin/Radarr ve dentro del contenedor.

Un segundo dispositivo de almacenamiento de ZimaOS no se encuentra automáticamente bajo /DATA

Barra lateral Archivos de ZimaOS que muestra los dispositivos de almacenamiento ZimaOS-HD, Zima-Media y Zima-Extra por separado
La nueva unidad NVMe del usuario aparecía como un espacio de almacenamiento independiente, por lo que escribir otra ruta /DATA/... creaba una carpeta en el almacenamiento equivocado.

Esa era la confusión principal. /DATA/extra-movies hacía referencia al área de datos del sistema o predeterminada, no automáticamente a la carpeta de la nueva unidad NVMe.

Zima-Giorgio sugirió comprobar /media

Para identificar manualmente la ruta del host, Giorgio sugirió:

ls /media

En ese momento, el almacenamiento independiente o montado aparecía bajo /media. La ruta exacta puede variar según la gestión de almacenamiento y el nombre del dispositivo actuales, así que utiliza la ruta que muestre la interfaz actual en lugar de adivinarla.

El selector de carpetas de la interfaz gráfica fue la solución confirmada en el caso original

Configuración de Jellyfin en ZimaOS que muestra el icono del selector de carpetas junto a la ruta del volumen multimedia del host
Zima-Giorgio indicó el selector de rutas de volumen para que el usuario pudiera seleccionar la carpeta del nuevo almacenamiento sin escribir manualmente la ruta de montaje.

La versión actual de ZimaOS permite explícitamente actualizar las rutas de los volúmenes después de mover los datos

La documentación actual de IceWhale sobre las rutas de las aplicaciones indica que, si una unidad se llena, puedes mover los datos de una aplicación a otra unidad y actualizar la ruta en la configuración de la aplicación sin reinstalarla.

Utiliza el flujo de trabajo actual de rutas Docker de ZimaOS.

Mantén estable la ruta del contenedor siempre que sea posible

Si Jellyfin ya utiliza internamente /Media, cambia únicamente el lado del host a la nueva carpeta física. Mantener estable la ruta del contenedor evita que la base de datos o la biblioteca de la aplicación detecten una cadena de ruta completamente distinta.

Actualiza todas las aplicaciones que asignen la carpeta movida

Radarr, Sonarr, qBittorrent, Jellyfin, Plex y las herramientas de importación pueden tener su propia asignación de volumen. Que una aplicación vea la nueva carpeta no actualiza las demás.

Archivos de ZimaOS que muestran las carpetas Books, Movies, Music y TV Shows en el dispositivo de almacenamiento Zima-Media
Después de la migración, cada contenedor dependiente debe asignarse a la carpeta multimedia real del nuevo dispositivo de almacenamiento.

Verifica todo antes de eliminar la carpeta anterior

Abre una película en Jellyfin, deja que Radarr analice la carpeta raíz, prueba las rutas de importación de qBittorrent si corresponde y confirma los permisos. Conserva la carpeta de origen anterior hasta comprobar que todas las aplicaciones utilizan correctamente la nueva asignación del host.

Mover archivos multimedia no es lo mismo que mover AppData

Las carpetas de películas y series son bibliotecas de contenido normales. AppData puede contener bases de datos SQLite/PostgreSQL, miniaturas, índices y el estado de la aplicación, elementos que pueden requerir detener la aplicación o utilizar la migración de datos de ZimaOS para mantener la coherencia. No trates todos los volúmenes como si fueran simples carpetas multimedia que se pueden arrastrar y soltar.

Vuelve a comprobar los permisos en el nuevo almacenamiento

Una nueva ruta del host correcta puede seguir fallando si la identidad del contenedor puede leer la unidad anterior, pero no la nueva. Después de volver a asignar la ruta, verifica que la aplicación pueda leer y, cuando sea necesario, escribir en la carpeta de destino sin conceder permisos de escritura globales innecesarios.

Preguntas frecuentes sobre las rutas multimedia movidas

¿Por qué Jellyfin perdió los archivos después de moverlos?

Su montaje de enlace Docker seguía apuntando a la carpeta anterior del host.

¿El usuario confirmó que el selector gráfico le ayudó?

Sí. Respondió de inmediato que no sabía que existía el selector de rutas y que este resolvió su confusión.

¿Debo escribir /DATA para cada nueva unidad de almacenamiento?

No. Utiliza la ruta real del host que ZimaOS muestre o seleccione para ese dispositivo de almacenamiento.