Solución de la comunidad

Por qué apt no está disponible en ZimaOS: Buildroot, archivos del sistema de solo lectura y aplicaciones Docker

An October 2024 beginner thread where apt commands failed even from root/ttydBridge. The community correctly explained that ZimaOS is an appliance OS rather than Ubuntu/Debian and does not support installing host packages with apt. Current official documentation now explicitly describes ZimaOS as Buildroot-based, mostly read-only, and container-oriented.

apt: command not found en ZimaOS no significa que sudo esté averiado. Significa que ZimaOS no es Ubuntu ni Debian y no incluye el flujo de gestión de paquetes APT que utilizan esas distribuciones. El usuario de origen de octubre de 2024 había iniciado sesión como root y mediante ttydBridge, pero aun así no podía actualizar ni instalar paquetes en el sistema anfitrión porque así no es como está diseñado ZimaOS.

La documentación actual de IceWhale aclara mejor la arquitectura: ZimaOS está basado en Buildroot, la mayoría de las carpetas del sistema son de solo lectura incluso como root, y se espera que las aplicaciones se ejecuten mediante contenedores en lugar de instalarse en el sistema operativo anfitrión con apt, yum o herramientas similares.

El problema no era sudo

El usuario original pensó que estaban fallando los «comandos sudo» porque comandos como sudo apt ... devolvían errores de comando no encontrado.

sudo solo cambia el contexto de privilegios. No puede crear un gestor de paquetes que no esté instalado en el sistema operativo.

ZimaOS está basado en Buildroot

Las guías actuales de IceWhale describen ZimaOS como un sistema Buildroot de tipo dispositivo dedicado. Buildroot produce una imagen de Linux embebido compacta, en lugar de una distribución de propósito general con una base de datos de paquetes modificable y repositorios APT convencionales.

Por eso, intentar aplicar tutoriales de gestión de paquetes de Debian/Ubuntu en el anfitrión ZimaOS suele fallar, aunque haya muchos comandos de Linux conocidos disponibles.

La mayoría de los directorios del sistema son intencionadamente de solo lectura

La guía actual de la CLI de ZimaOS indica que la mayoría de las carpetas del sistema permanecen en modo de solo lectura incluso cuando el usuario inicia sesión como root. Los datos de usuario y de las aplicaciones que se puedan modificar deben almacenarse en /DATA.

Consulta el modelo actual del sistema de archivos de la CLI de ZimaOS antes de intentar modificar el sistema operativo base.

Usa Docker para las aplicaciones de servidor

Si un tutorial dice «instala este servicio con apt», comprueba primero si la misma aplicación tiene una imagen de Docker o una pila de Compose mantenida. Ese es el modelo de aplicaciones nativo de ZimaOS y mantiene las dependencias separadas del anfitrión inmutable.

Esto se aplica a servidores multimedia, herramientas de monitorización, bases de datos, clientes VPN, plataformas de automatización, servicios de documentos y muchas otras aplicaciones de laboratorio doméstico.

Usa ZVM cuando el software realmente necesite un anfitrión Debian/Ubuntu completo

Algunas aplicaciones esperan encontrar systemd, un gestor de paquetes, módulos del kernel o varios servicios a nivel del sistema operativo. En ese caso, una máquina virtual Debian o Ubuntu es más adecuada que intentar obligar al anfitrión ZimaOS a comportarse como uno de ellos.

Dentro de la máquina virtual, la gestión normal de paquetes con apt funciona porque el sistema operativo invitado es realmente Debian/Ubuntu.

SSH y ttydBridge siguen siendo útiles

Que la instalación de paquetes no sea compatible no significa que la línea de comandos sea inútil. SSH y el terminal web siguen siendo valiosos para realizar inspecciones, consultar registros, ejecutar comandos de Docker, gestionar archivos en el almacenamiento modificable y llevar a cabo tareas avanzadas de resolución de problemas.

La guía actual de IceWhale admite tanto SSH como un terminal en el navegador mediante el Modo de desarrollador.

El problema del usuario de origen con Jellyfin no estaba relacionado con apt

Más tarde, el autor original mencionó que algunos vídeos se reproducían en Archivos, pero no en Jellyfin. Las respuestas de IceWhale y de la comunidad lo orientaron hacia la configuración de las rutas multimedia de Docker.

Esa es la separación correcta: un problema de reproducción o de biblioteca dentro de Jellyfin debe depurarse mediante los mapeos de volúmenes de la aplicación, los códecs, la transcodificación y los registros, no instalando paquetes aleatorios en el anfitrión con APT.

Preguntas frecuentes sobre apt en ZimaOS

¿Puedo instalar apt en el anfitrión ZimaOS?

ZimaOS no está diseñado en torno a la gestión de paquetes APT; utiliza contenedores o una máquina virtual en lugar de tratar el anfitrión como si fuera Debian.

¿El acceso root hace que las carpetas del sistema sean modificables?

No. ZimaOS mantiene intencionadamente la mayoría de las carpetas del sistema en modo de solo lectura, incluso para root.

¿Dónde deben almacenarse los scripts personalizados y los archivos modificables?

Utiliza una ubicación modificable dentro de /DATA u otra ruta de almacenamiento de datos gestionada.