Communityoplossing

Docker Compose bewerken voor geïnstalleerde ZimaOS-apps: wat is er veranderd met 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.

In januari 2026 konden gebruikers die een app uit de ZimaOS App Store installeerden, blootgestelde instellingen zoals poorten, omgevingsvariabelen en volumes wijzigen, maar ze hadden niet dezelfde Compose-niveaucontrole als over een stack die ze zelf beheerden. Dat werd een probleem voor geavanceerde instellingen zoals Traefik-labels, gedeelde netwerken, middleware of containerspecifieke DNS.

De belangrijke update is dat de roadmap uit de thread niet langer uitsluitend over de toekomst gaat. IceWhale gaf aan de App Store te refactoren om het bewerken van Docker Compose-YAML toe te voegen, en ZimaOS 1.7.0 bracht later native YAML-ondersteuning uit.

Waarom App Store-apps begin 2026 moeilijk te bewerken waren

Volgens de uitleg van de community werden apps die uit de store waren geïnstalleerd, beheerd door ZimaOS. Het bewerken van gegenereerde Compose-configuratie buiten dat beheerpad kon bij nieuwe implementaties of upgrades worden overschreven.

Voor gevorderde gebruikers was de praktische tijdelijke oplossing om de service als Custom Compose te installeren, dezelfde permanente AppData-mappen te behouden en de Compose-stack zelf te beheren met een tool zoals Dockge of Portainer.

Geavanceerde reverse-proxy-instellingen vereisen controle op Compose-niveau

De oorspronkelijke gebruiker wilde specifiek Traefik-labels instellen en bepaalde containers dwingen Cloudflare-DNS te gebruiken in plaats van Pi-hole. Dat zijn normale Docker Compose-aangelegenheden en geen eenvoudige instellingen voor appnaam of poort.

De huidige specificaties voor ZimaOS-apps uit de store maken deze grens expliciet: de standaardruntimeconfiguratie hoort in Docker Compose, terwijl ZimaOS-specifieke storemetagegevens in x-casaos horen.

IceWhale bevestigde dat er een YAML-editor gepland was

Zima-Jerry antwoordde dat het team de App Store en de installatie-ervaring aan het refactoren was, zodat een eenvoudige installatiemethode kon samengaan met geavanceerde bewerking van Docker Compose-YAML.

Dat officiële antwoord is gezaghebbender dan de eerdere aanname van de community dat store-apps nooit rechtstreeks konden worden bewerkt.

ZimaOS 1.7.0 voegde native YAML-ondersteuning toe

In juli 2026 bracht ZimaOS App Store 2.0 een vernieuwd appbeheer en native YAML-ondersteuning uit voor flexibelere applicatieconfiguratie. Het huidige ZimaOS centraliseert ook de status, updates en algemene instellingen van geïnstalleerde apps op de pagina voor appbeheer.

Het huidige App Store-overzicht laat zien hoe geïnstalleerde apps nu vanuit de vernieuwde applicatie-interface van ZimaOS worden beheerd.

Native YAML betekent niet dat elke externe stack automatisch wordt beheerd

De nieuwe editor biedt meer controle over door ZimaOS beheerde applicaties, maar dat mag niet worden verward met volledig eigenaarschap over willekeurige Compose-stacks die buiten het ZimaOS-appsysteem zijn gestart. In de huidige 1.7.x-versies wordt nog steeds onderscheid gemaakt tussen handmatig gestarte Compose-groepen en apps die ZimaOS zelf beheert.

Behoud AppData wanneer je van beheermodel verandert

Als je een app bewust verplaatst van een beheerd storepakket naar een zelf beheerde Compose-stack, staan de belangrijke gegevens normaal gesproken in de permanente hostmappen. Maak daar eerst een back-up van en reproduceer vervolgens dezelfde volumekoppelingen, poorten, omgevingswaarden en databaseafhankelijkheden voordat je de oude container verwijdert.

Ga er niet van uit dat het opnieuw aanmaken van een container automatisch alle ZimaOS-specifieke instellingen of geheimen migreert.

Veelgestelde vragen over het bewerken van ZimaOS-app-YAML

Was rechtstreeks bewerken van Compose beschikbaar toen de thread werd geplaatst?

Niet op de manier die de gebruiker wilde. De oplossing van de community was Custom Compose, terwijl IceWhale aangaf dat rechtstreeks bewerken van YAML in ontwikkeling was.

Heeft ZimaOS uiteindelijk native YAML-bewerking toegevoegd?

Ja. ZimaOS 1.7.0 kondigde native YAML-ondersteuning aan als onderdeel van het herontwerp van App Store 2.0.

Moet ik Dockge nog steeds gebruiken?

Dat kan nog steeds zinvol zijn als je bewust een onafhankelijke Compose-stack zelf wilt beheren in plaats van ZimaOS de applicatie te laten beheren.

Kan ik bestaande applicatiegegevens behouden wanneer ik overstap naar Custom Compose?

Vaak wel, als de permanente hostmappen behouden blijven en correct opnieuw worden gekoppeld. Maak echter eerst een back-up van de gegevens en leg de oorspronkelijke containerinstellingen vast.