La edición manual de Compose omitió las variables gestionadas por ZimaOS
Un nuevo usuario de ZimaOS editó manualmente el archivo Compose de Jellyfin para cambiar las rutas de almacenamiento. Después de reiniciar, Compose advirtió que PGID, PUID, TZ y AppID no estaban definidas, y varias asignaciones de dispositivos de hardware no funcionaban como se esperaba.
La respuesta de la comunidad explicó que ZimaOS normalmente inyecta esos valores mediante su capa de gestión de aplicaciones. Editar el YAML generado fuera de ese flujo de trabajo puede dejar marcadores de posición sin el entorno que ZimaOS esperaba proporcionar.
Cambia el almacenamiento mediante los ajustes de la aplicación y los volúmenes
La opción recomendada era abrir los ajustes de la aplicación Jellyfin y modificar allí las asignaciones de volúmenes, en lugar de reescribir el archivo Compose. De este modo, ZimaOS puede conservar los metadatos de la aplicación, las variables de entorno y las entradas de dispositivos mientras aplica las rutas de almacenamiento del host elegidas.
Más tarde, el autor confirmó que este método funcionaba. Una vez seleccionadas las rutas correctas de la unidad secundaria en los ajustes de la aplicación, Jellyfin funcionó correctamente sin el flujo de trabajo manual de Compose.
La reinstalación restaura la configuración proporcionada por la tienda
Si la configuración generada ya se ha modificado considerablemente, la respuesta propuso eliminar Jellyfin del panel y reinstalarlo desde la tienda de aplicaciones para restaurar los valores predeterminados originales. Los datos existentes de la aplicación deben conservarse mediante asignaciones correctas de volúmenes del host antes de eliminarla; reinstalar un contenedor no sustituye la copia de seguridad de su configuración.
La reparación manual sigue siendo posible solo si se definen correctamente todas las variables que faltan y las rutas de dispositivos necesarias. El hilo recomendó la interfaz de ajustes de ZimaOS porque reducía la posibilidad de omitir valores gestionados.
La asignación de discos en Proxmox era una complicación aparte
El autor ejecutaba ZimaOS como máquina virtual en Proxmox sobre Debian 13. Un disco pasado mediante un comando qm set y un montaje obsoleto en /etc/fstab provocaban problemas en el modo de mantenimiento después de reiniciar. ZimaOS también asignaba al dispositivo un nombre diferente del esperado por el usuario.
Ese problema de virtualización era independiente de las variables de Compose que faltaban. Para obtener un resultado funcional se necesitaban tanto una asignación estable del disco de la máquina virtual como rutas correctas para los volúmenes de Jellyfin en la interfaz de aplicaciones de ZimaOS.
La pregunta posterior sobre NTP no formaba parte de la solución de Jellyfin
Después de que Jellyfin funcionara, el hilo pasó a tratar la sincronización horaria. El comportamiento de NTP en el host y el invitado de Proxmox no causaba las advertencias de Compose, por lo que debía diagnosticarse por separado.
Preguntas frecuentes
¿Por qué PUID, PGID, TZ y AppID aparecían vacías?
Las advertencias aparecieron después de que las ediciones manuales omitieran los valores que normalmente gestiona la capa de aplicaciones de ZimaOS.
¿Dónde deben cambiarse las rutas de almacenamiento de Jellyfin?
La solución confirmada era utilizar los ajustes de la aplicación Jellyfin en ZimaOS y sus controles de volumen.
¿Los dispositivos de hardware que faltaban requerían controladores nuevos?
El hilo no estableció que hubiera un fallo de controladores. Restaurar la configuración gestionada de la aplicación y las rutas de los volúmenes resolvió la instalación de Jellyfin del autor.
