Community-Lösung

Docker Compose für installierte ZimaOS-Apps bearbeiten: Was sich mit dem App Store 2.0 geändert hat

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.

Im Januar 2026 konnten Nutzer, die eine App aus dem ZimaOS App Store installiert hatten, offengelegte Einstellungen wie Ports, Umgebungsvariablen und Volumes ändern, verfügten jedoch nicht über dieselbe Compose-Kontrolle wie bei einem Stack, den sie selbst verwalteten. Das wurde bei erweiterten Einstellungen wie Traefik-Labels, gemeinsam genutzten Netzwerken, Middleware oder containerspezifischem DNS zum Problem.

Die wichtige Aktualisierung ist, dass die Roadmap des Threads inzwischen nicht mehr ausschließlich die Zukunft betrifft. IceWhale erklärte, den App Store zu überarbeiten, um die Bearbeitung von Docker-Compose-YAML hinzuzufügen, und ZimaOS 1.7.0 wurde später mit nativer YAML-Unterstützung veröffentlicht.

Warum sich App-Store-Apps Anfang 2026 nur schwer bearbeiten ließen

Die Erklärung der Community lautete, dass aus dem Store installierte Apps von ZimaOS verwaltet wurden. Änderungen an generiertem Compose außerhalb dieses Verwaltungswegs konnten durch erneute Bereitstellungen oder Upgrades überschrieben werden.

Für fortgeschrittene Nutzer bestand der praktische Workaround damals darin, den Dienst als Custom Compose zu installieren, dieselben persistenten AppData-Ordner beizubehalten und den Compose-Stack selbst mit einem Tool wie Dockge oder Portainer zu verwalten.

Erweiterte Reverse-Proxy-Einstellungen erfordern Kontrolle auf Compose-Ebene

Der ursprüngliche Nutzer wollte konkret Traefik-Labels und eine Möglichkeit, ausgewählte Container statt Pi-hole zur Verwendung des Cloudflare-DNS zu zwingen. Dabei handelt es sich um typische Docker-Compose-Anforderungen und nicht um einfache Einstellungen für App-Titel oder Ports.

Die aktuellen Spezifikationen für ZimaOS-Apps aus dem App Store machen diese Abgrenzung deutlich: Die standardmäßige Laufzeitkonfiguration gehört in Docker Compose, während ZimaOS-spezifische Store-Metadaten in x-casaos gehören.

IceWhale bestätigte, dass ein YAML-Editor geplant war

Zima-Jerry antwortete, dass das Team den App Store und die Installationserfahrung überarbeite, damit ein einfacher Installationsweg mit einer erweiterten Bearbeitung von Docker-Compose-YAML koexistieren könne.

Diese offizielle Antwort ist maßgeblicher als die frühere Annahme der Community, dass sich Store-Apps niemals direkt bearbeiten ließen.

ZimaOS 1.7.0 fügte native YAML-Unterstützung hinzu

Bis Juli 2026 wurde ZimaOS App Store 2.0 mit einer überarbeiteten App-Verwaltung und nativer YAML-Unterstützung für eine flexiblere Anwendungskonfiguration veröffentlicht. Das aktuelle ZimaOS bündelt außerdem den Status installierter Apps, Aktualisierungen und allgemeine Einstellungen auf der App-Verwaltungsseite.

Die aktuelle Übersicht des App Stores zeigt wie installierte Apps jetzt über die überarbeitete Anwendungsoberfläche von ZimaOS verwaltet werden.

Native YAML-Unterstützung bedeutet nicht, dass jeder externe Stack automatisch verwaltet wird

Der neue Editor verbessert die Kontrolle über von ZimaOS verwaltete Anwendungen. Das sollte jedoch nicht mit der vollständigen Verwaltung beliebiger Compose-Stacks verwechselt werden, die außerhalb des ZimaOS-App-Systems gestartet wurden. Aktuelle Berichte zu Version 1.7.x unterscheiden weiterhin zwischen manuell gestarteten Compose-Gruppen und Apps, die ZimaOS selbst verwaltet.

AppData beim Wechsel des Verwaltungsmodells bewahren

Wenn Sie eine App bewusst von einem verwalteten Store-Paket zu einem selbst verwalteten Compose-Stack verschieben, befinden sich die wichtigen Daten normalerweise in den persistenten Host-Ordnern. Sichern Sie diese zunächst und stellen Sie dann dieselben Volume-Zuordnungen, Ports, Umgebungswerte und Datenbankabhängigkeiten wieder her, bevor Sie den alten Container entfernen.

Gehen Sie nicht davon aus, dass das Neuerstellen eines Containers automatisch alle ZimaOS-spezifischen Einstellungen oder Geheimnisse migriert.

FAQ zur Bearbeitung von ZimaOS-App-YAML

War die direkte Bearbeitung von Compose verfügbar, als der Thread veröffentlicht wurde?

Nicht in der vom Nutzer gewünschten Form. Der Workaround der Community war Custom Compose, während IceWhale erklärte, dass eine direkte YAML-Bearbeitung entwickelt werde.

Hat ZimaOS später eine native YAML-Bearbeitung hinzugefügt?

Ja. ZimaOS 1.7.0 kündigte native YAML-Unterstützung als Teil der Überarbeitung des App Store 2.0 an.

Sollte ich weiterhin Dockge verwenden?

Das kann weiterhin sinnvoll sein, wenn Sie bewusst einen unabhängigen Compose-Stack selbst verwalten möchten, anstatt die Anwendung von ZimaOS verwalten zu lassen.

Kann ich vorhandene Anwendungsdaten behalten, wenn ich zu Custom Compose wechsle?

Oft ja, sofern die persistenten Host-Ordner beibehalten und korrekt neu zugeordnet werden. Sichern Sie die Daten jedoch zuvor und dokumentieren Sie zunächst die ursprünglichen Containereinstellungen.