apt: command not found sur ZimaOS ne signifie pas que sudo est défaillant. Cela signifie que ZimaOS n’est ni Ubuntu ni Debian et n’inclut pas le système de gestion des paquets APT utilisé par ces distributions. L’utilisateur de la source d’octobre 2024 était connecté en tant que root et via ttydBridge, mais ne pouvait toujours pas mettre à jour ni installer de paquets sur l’hôte, car ce n’est pas ainsi que ZimaOS est conçu.
La documentation actuelle d’IceWhale clarifie désormais davantage l’architecture : ZimaOS est basé sur Buildroot, la plupart des dossiers système sont en lecture seule, même pour root, et les applications sont censées s’exécuter dans des conteneurs plutôt que d’être installées dans le système d’exploitation hôte avec apt, yum ou des outils similaires.
sudo n’était pas le problème
L’utilisateur d’origine pensait que les « commandes sudo » échouaient, car des commandes telles que sudo apt ... renvoyaient des erreurs indiquant que la commande était introuvable.
sudo ne fait que modifier le contexte des privilèges. Il ne peut pas créer un gestionnaire de paquets qui n’est pas installé dans le système d’exploitation.
ZimaOS est basé sur Buildroot
Les guides actuels d’IceWhale décrivent ZimaOS comme un système Buildroot de type appliance. Buildroot produit une image Linux embarquée compacte plutôt qu’une distribution généraliste dotée d’une base de paquets modifiable et de dépôts APT classiques.
C’est pourquoi les tutoriels de gestion des paquets Debian/Ubuntu échouent souvent sur l’hôte ZimaOS, même si de nombreuses commandes Linux familières sont disponibles.
La plupart des répertoires système sont intentionnellement en lecture seule
Les instructions CLI actuelles de ZimaOS indiquent que la plupart des dossiers système restent en lecture seule, même lorsque l’utilisateur se connecte en tant que root. Les données utilisateur et applicatives modifiables doivent se trouver sous /DATA.
Consultez le modèle actuel du système de fichiers CLI de ZimaOS avant d’essayer de modifier le système d’exploitation de base.
Utilisez Docker pour les applications serveur
Si un tutoriel indique « installez ce démon avec apt », vérifiez d’abord si la même application dispose d’une image Docker ou d’une stack Compose maintenue. Il s’agit du modèle applicatif natif de ZimaOS, qui sépare les dépendances de l’hôte immuable.
Cela s’applique aux serveurs multimédias, outils de surveillance, bases de données, clients VPN, plateformes d’automatisation, services de gestion documentaire et à de nombreuses autres applications de homelab.
Utilisez ZVM lorsque le logiciel a réellement besoin d’un hôte Debian/Ubuntu complet
Certaines applications nécessitent systemd, un gestionnaire de paquets, des modules du noyau ou plusieurs services au niveau du système d’exploitation. Dans ce cas, une machine virtuelle Debian ou Ubuntu convient mieux que d’essayer de forcer l’hôte ZimaOS à se comporter comme l’une de ces distributions.
Dans la machine virtuelle, la gestion habituelle des paquets avec apt fonctionne, car le système d’exploitation invité est réellement Debian/Ubuntu.
SSH et ttydBridge restent utiles
Le fait que l’installation de paquets ne soit pas prise en charge ne rend pas la ligne de commande inutile. SSH et le terminal web restent utiles pour l’inspection, les journaux, les commandes Docker, les opérations sur les fichiers dans le stockage modifiable et le dépannage avancé.
Les instructions actuelles d’IceWhale prennent en charge SSH ainsi qu’un terminal accessible depuis un navigateur via le mode développeur.
Le problème Jellyfin de l’utilisateur source n’était pas lié à apt
L’auteur du message original a ensuite indiqué que certaines vidéos étaient lisibles dans Files, mais pas dans Jellyfin. Les réponses d’IceWhale et de la communauté l’ont orienté vers la configuration des chemins multimédias de Docker.
Il s’agit de la bonne distinction : un problème de lecture ou de bibliothèque dans Jellyfin doit être diagnostiqué à partir des mappages de volumes de l’application, des codecs, du transcodage et des journaux, et non en installant des paquets hôte au hasard avec APT.
FAQ sur apt dans ZimaOS
Puis-je installer apt sur l’hôte ZimaOS ?
ZimaOS n’est pas conçu autour de la gestion des paquets APT ; utilisez plutôt des conteneurs ou une machine virtuelle au lieu de traiter l’hôte comme un système Debian.
L’accès root permet-il de rendre les dossiers système modifiables ?
Non. ZimaOS conserve intentionnellement la plupart des dossiers système en lecture seule, même pour root.
Où doivent se trouver les scripts personnalisés et les fichiers modifiables ?
Utilisez un emplacement modifiable sous /DATA ou un autre chemin de stockage de données géré.
