Solution communautaire

Modifier Docker Compose pour les applications ZimaOS installées : qu’est-ce qui a changé avec l’App Store 2.0 ?

A January 2026 discussion about adding Traefik labels and custom DNS to installed ZimaOS apps. IceWhale said it was refactoring the App Store to add direct YAML editing; ZimaOS 1.7.0 later introduced native YAML support.

En janvier 2026, les utilisateurs qui avaient installé une application depuis l’App Store de ZimaOS pouvaient modifier des paramètres exposés tels que les ports, les variables d’environnement et les volumes, mais ne disposaient pas du même niveau de contrôle au niveau de Compose que pour une stack qu’ils géraient eux-mêmes. Cela posait problème pour les paramètres avancés tels que les labels Traefik, les réseaux partagés, les middlewares ou le DNS propre à certains conteneurs.

La mise à jour importante est que la feuille de route évoquée dans le fil n’est plus entièrement au futur. IceWhale avait annoncé la refonte de l’App Store afin d’ajouter la modification des fichiers YAML Docker Compose, et ZimaOS 1.7.0 a ensuite intégré la prise en charge native du YAML.

Pourquoi les applications de l’App Store étaient difficiles à modifier début 2026

L’explication donnée par la communauté était que les applications installées depuis la boutique étaient gérées par ZimaOS. La modification du fichier Compose généré en dehors de ce circuit de gestion pouvait être écrasée lors d’un nouveau déploiement ou d’une mise à niveau.

Pour les utilisateurs avancés, la solution de contournement pratique à l’époque consistait à installer le service en tant que Compose personnalisé, à conserver les mêmes dossiers AppData persistants, puis à gérer soi-même la stack Compose avec un outil tel que Dockge ou Portainer.

Les paramètres avancés de proxy inverse nécessitent un contrôle au niveau de Compose

L’utilisateur d’origine voulait précisément ajouter des labels Traefik et forcer certains conteneurs à utiliser le DNS de Cloudflare plutôt que Pi-hole. Il s’agit de paramètres courants de Docker Compose, et non de simples options liées au titre de l’application ou aux ports.

Les spécifications actuelles des applications de l’App Store de ZimaOS définissent explicitement cette séparation : la configuration standard de l’environnement d’exécution doit se trouver dans Docker Compose, tandis que les métadonnées propres à la boutique ZimaOS doivent se trouver dans x-casaos.

IceWhale a confirmé qu’un éditeur YAML était prévu

Zima-Jerry a répondu que l’équipe remaniait l’App Store et l’expérience d’installation afin de permettre à une procédure d’installation simple de coexister avec la modification avancée des fichiers YAML Docker Compose.

Cette réponse officielle est plus fiable que l’hypothèse avancée précédemment par la communauté selon laquelle les applications de la boutique ne pourraient jamais être modifiées directement.

ZimaOS 1.7.0 a ajouté la prise en charge native du YAML

En juillet 2026, l’App Store 2.0 de ZimaOS a introduit une refonte de la gestion des applications ainsi que la prise en charge native du YAML, pour offrir une configuration plus flexible. Les versions actuelles de ZimaOS centralisent également l’état des applications installées, les mises à jour et les paramètres courants dans la page de gestion des applications.

La présentation actuelle de l’App Store montre comment les applications installées sont désormais gérées depuis la nouvelle interface des applications de ZimaOS.

La prise en charge native du YAML ne signifie pas que chaque stack externe est gérée automatiquement

Le nouvel éditeur améliore le contrôle des applications gérées par ZimaOS, mais il ne faut pas le confondre avec la prise en charge complète de n’importe quelle stack Compose lancée en dehors du système d’applications de ZimaOS. Les rapports actuels concernant la version 1.7.x distinguent toujours les groupes Compose lancés manuellement des applications gérées directement par ZimaOS.

Conservez les données AppData lorsque vous changez de mode de gestion

Si vous déplacez volontairement une application d’un paquet géré par la boutique vers une stack Compose que vous administrez vous-même, les données importantes se trouvent généralement dans ses dossiers persistants sur l’hôte. Sauvegardez-les d’abord, puis reproduisez les mêmes associations de volumes, ports, valeurs d’environnement et dépendances de base de données avant de supprimer l’ancien conteneur.

Ne supposez pas que la recréation d’un conteneur migre automatiquement tous les paramètres ou secrets propres à ZimaOS.

FAQ sur la modification du YAML des applications ZimaOS

La modification directe de Compose était-elle disponible au moment de la publication du fil ?

Pas de la manière souhaitée par l’utilisateur. La solution de contournement proposée par la communauté était le Compose personnalisé, tandis qu’IceWhale indiquait que la modification directe du YAML était en cours de développement.

ZimaOS a-t-il finalement ajouté la modification native du YAML ?

Oui. ZimaOS 1.7.0 a annoncé la prise en charge native du YAML dans le cadre de la refonte de l’App Store 2.0.

Devrais-je toujours utiliser Dockge ?

Cela peut rester pertinent si vous souhaitez délibérément gérer une stack Compose indépendante plutôt que laisser ZimaOS administrer l’application.

Puis-je conserver les données existantes d’une application en passant au Compose personnalisé ?

Souvent, oui, si les dossiers persistants sur l’hôte sont conservés et correctement remappés. Sauvegardez toutefois les données et consignez d’abord les paramètres d’origine du conteneur.