Solution communautaire

Pourquoi apt et yum ne fonctionnent pas sur ZimaOS : Buildroot, modules zpkg, conteneurs et WebDAV

A November 2024-July 2025 thread where apt, apt-get, and yum failed because ZimaOS is Buildroot-based rather than Debian/Ubuntu. A later user wanted davfs2 for a host-level WebDAV mount so it would appear in Files. IceWhale did not provide an apt-style package-manager solution and instead explored container alternatives.

apt install, apt-get update, et yum install échouent sur ZimaOS, car ZimaOS n’est pas une distribution généraliste de type Debian, Ubuntu, Fedora ou RHEL. Il est conçu avec Buildroot comme système d’exploitation pour appliance et conserve la plupart des dossiers système en lecture seule.

ZimaOS dispose désormais de mécanismes similaires à ceux des gestionnaires de paquets pour des usages spécifiques — notamment les modules zpkg, tandis que certaines documentations destinées aux développeurs utilisent Entware/opkg pour des outils spécialisés. Cela ne transforme pas le système d’exploitation de base en distribution Linux classique et modifiable, où des paquets hôtes arbitraires peuvent être installés et intégrés comme des paquets Debian.

L’utilisateur source a essayé apt, apt-get et yum

L’article original de 2024 indiquait que les trois approches de gestionnaires de paquets échouaient via SSH. Une réponse de la communauté expliquait que ZimaOS est conçu avec Buildroot et combine des composants Linux, glibc, systemd, Docker et de virtualisation sans base de données de paquets de type Debian.

Cette explication architecturale reste exacte.

ZimaOS conserve actuellement la plupart des chemins système en lecture seule

Les recommandations CLI actuelles d’IceWhale indiquent explicitement que la plupart des dossiers système restent en lecture seule, même avec les privilèges root. Les données utilisateur et les données des applications doivent se trouver sous /DATA.

Consultez le modèle actuel du système de fichiers CLI de ZimaOS.

Pour les applications, Docker est le principal modèle d’extension

Si le logiciel existe sous la forme d’une image Docker ou d’une pile Compose maintenue, il s’agit généralement de la méthode de déploiement la plus native à ZimaOS. Les dépendances restent dans le conteneur et ne modifient pas le système d’exploitation de base.

C’est pourquoi la réponse d’IceWhale à la demande WebDAV ultérieure a exploré une application basée sur Docker plutôt que de conseiller à l’utilisateur d’installer davfs2 avec APT.

zpkg est un gestionnaire de modules ZimaOS, pas apt

ZimaOS utilise actuellement zpkg pour les modules système installables, comme les extensions d’IA et de recherche ainsi que les modules communautaires ou officiels. Un module est conçu pour le mécanisme d’extension de ZimaOS et peut intégrer sa propre politique de service.

Ce n’est pas un remplacement générique permettant d’installer des noms de paquets Debian arbitraires tels que davfs2 peut être installé.

IceWhale documente également opkg pour les environnements de développement spécialisés

Les recommandations actuelles d’IceWhale pour Python et le développement indiquent d’installer Entware sous /opt puis en utilisant opkg pour les utilitaires de développement tels que git-http.

Il s’agit d’une méthode avancée prise en charge dans ce guide particulier, et non d’une autorisation de supposer que tout daemon Linux installé depuis Entware s’intégrera sans risque au démarrage de ZimaOS, à ses services Fichiers, réseau ou stockage.

Utilisez le workflow actuel Entware/opkg pour les développeurs uniquement lorsqu’il correspond au cas d’utilisation prévu.

La demande WebDAV ultérieure nécessitait une intégration au niveau de l’hôte

En 2025, l’utilisateur voulait monter un disque cloud WebDAV au niveau du système d’exploitation afin qu’il soit accessible depuis l’expérience ZimaOS Files et par d’autres applications. Il a explicitement indiqué qu’une application distincte de type AList ne constituait pas une solution équivalente.

Cette exigence est plus complexe que « exécuter un conteneur client WebDAV », car le montage d’un conteneur ne devient pas automatiquement un montage hôte natif visible dans Files et par tous les autres conteneurs.

Un conteneur peut néanmoins répondre à certains flux de travail WebDAV

Si l’objectif réel est de parcourir, synchroniser ou copier des données vers un fournisseur WebDAV, un outil conteneurisé peut être plus sûr que de modifier l’hôte. Il peut s’agir, par exemple, de clients de synchronisation, de gestionnaires de fichiers ou d’outils de sauvegarde prenant directement en charge WebDAV.

Ne mappez que les dossiers ZimaOS dont le conteneur a besoin et conservez les identifiants du fournisseur dans la configuration protégée de l’application.

Utilisez une VM lorsque le logiciel requiert un hôte Linux normalement modifiable

Si un flux de travail nécessite réellement apt install davfs2, les paquets système, le comportement de FUSE/du noyau ou les services de démarrage personnalisés, une VM Debian/Ubuntu peut constituer une séparation plus propre. Dans le système invité, la gestion normale des paquets est prise en charge, car le système invité est réellement Debian/Ubuntu.

Exposez ensuite les données montées à ZimaOS ou à d’autres clients via un protocole réseau/de stockage délibéré si nécessaire.

Les modifications de l’hôte doivent survivre au cycle de vie immuable

Même lorsqu’une solution avancée permet de rendre un binaire disponible sous /opt ou /DATA, vérifiez :

  • le service démarre après un redémarrage ;
  • il résiste aux mises à jour OTA ;
  • les identifiants sont conservés de manière sécurisée ;
  • le montage existe avant le démarrage des applications qui en dépendent ;
  • une défaillance n’entraîne pas l’écriture des applications dans un point de montage local vide.

Un montage hôte n’est pas automatiquement une intégration à Files

ZimaOS Files est un service natif doté de son propre modèle de stockage et d’emplacements réseau. La création d’un montage FUSE/WebDAV personnalisé depuis un shell ne garantit pas qu’il apparaîtra comme un emplacement natif dans Files ni qu’il bénéficiera des mêmes autorisations et de la même gestion du cycle de vie.

FAQ du gestionnaire de paquets ZimaOS

Pourquoi apt ne fonctionne-t-il pas sur ZimaOS ?

ZimaOS est basé sur Buildroot et n’utilise pas l’architecture de gestion des paquets APT de Debian/Ubuntu.

zpkg est-il un remplacement général d’apt ?

Non. zpkg installe des modules ZimaOS conçus pour le système de modules de la plateforme.

IceWhale documente-t-il parfois opkg ?

Oui, dans une configuration spécialisée pour développeurs/Python utilisant Entware sous /opt. Cela ne transforme pas le système d’exploitation de base en distribution normalement modifiable.

Et si j’ai spécifiquement besoin de davfs2 ou d’un autre démon hôte ?

Privilégiez un conteneur/module pris en charge lorsqu’il est disponible, ou exécutez une VM Linux généraliste lorsque le flux de travail dépend réellement d’une gestion normale des paquets et des services hôtes.