Nel gennaio 2026, gli utenti che installavano un’app dall’App Store di ZimaOS potevano modificare impostazioni esposte come porte, variabili d’ambiente e volumi, ma non disponevano dello stesso controllo a livello Compose di uno stack gestito autonomamente. Questo diventava un problema per impostazioni avanzate come le label di Traefik, le reti condivise, i middleware o il DNS specifico dei container.
L’aggiornamento importante è che la roadmap della discussione non è più soltanto proiettata al futuro. IceWhale ha dichiarato di stare rifattorizzando l’App Store per aggiungere la modifica dei file YAML Docker Compose, e in seguito ZimaOS 1.7.0 ha introdotto il supporto nativo per YAML.
Perché all’inizio del 2026 era difficile modificare le app dell’App Store
La spiegazione fornita dalla community era che le app installate dallo store fossero gestite da ZimaOS. La modifica del Compose generato al di fuori di questo percorso di gestione poteva essere sovrascritta durante nuove distribuzioni o aggiornamenti.
All’epoca, per gli utenti avanzati, la soluzione pratica consisteva nell’installare il servizio come Custom Compose, mantenere le stesse cartelle persistenti AppData e gestire autonomamente lo stack Compose con uno strumento come Dockge o Portainer.
Le impostazioni avanzate del reverse proxy richiedono un controllo a livello Compose
L’utente originale voleva in particolare le label di Traefik e un modo per obbligare determinati container a usare il DNS di Cloudflare invece di Pi-hole. Si tratta di normali esigenze di Docker Compose, non di semplici impostazioni relative al titolo dell’app o alle porte.
Le specifiche attuali delle app dell’App Store di ZimaOS rendono esplicito questo confine: la configurazione standard del runtime appartiene a Docker Compose, mentre i metadati specifici dello store di ZimaOS appartengono a x-casaos.
IceWhale ha confermato che era previsto un editor YAML
Zima-Jerry ha risposto che il team stava rifattorizzando l’App Store e l’esperienza di installazione, in modo da affiancare a un percorso di installazione semplice la modifica avanzata dei file YAML Docker Compose.
Quella risposta ufficiale è più autorevole della precedente supposizione della community secondo cui le app dello store non avrebbero mai potuto essere modificate direttamente.
ZimaOS 1.7.0 ha aggiunto il supporto nativo per YAML
A luglio 2026, ZimaOS App Store 2.0 ha introdotto una riprogettazione della gestione delle app e il supporto nativo per YAML, consentendo una configurazione delle applicazioni più flessibile. Le versioni attuali di ZimaOS centralizzano inoltre lo stato delle app installate, gli aggiornamenti e le impostazioni comuni nella pagina di gestione delle app.
La panoramica attuale dell’App Store mostra come vengono ora gestite le app installate dalla rinnovata interfaccia delle applicazioni di ZimaOS.
Il supporto nativo per YAML non significa che ogni stack esterno venga gestito automaticamente
Il nuovo editor offre un controllo migliore sulle applicazioni gestite da ZimaOS, ma non va confuso con la piena gestione di stack Compose arbitrari avviati al di fuori del sistema delle app di ZimaOS. Le segnalazioni attuali sulle versioni 1.7.x distinguono ancora i gruppi Compose avviati manualmente dalle app gestite direttamente da ZimaOS.
Conservare AppData quando si cambia modello di gestione
Se sposti deliberatamente un’app da un pacchetto gestito dallo store a uno stack Compose gestito autonomamente, i dati importanti si trovano normalmente nelle relative cartelle persistenti sull’host. Esegui prima un backup, quindi riproduci gli stessi mapping dei volumi, le porte, i valori delle variabili d’ambiente e le dipendenze del database prima di rimuovere il vecchio container.
Non dare per scontato che la ricreazione di un container trasferisca automaticamente tutte le impostazioni o tutti i segreti specifici di ZimaOS.
Domande frequenti sulla modifica dello YAML delle app di ZimaOS
La modifica diretta del Compose era disponibile quando è stata pubblicata la discussione?
Non nel modo desiderato dall’utente. La soluzione suggerita dalla community era Custom Compose, mentre IceWhale dichiarava che la modifica diretta dello YAML era in fase di sviluppo.
ZimaOS ha poi aggiunto la modifica nativa dello YAML?
Sì. ZimaOS 1.7.0 ha annunciato il supporto nativo per YAML nell’ambito della riprogettazione dell’App Store 2.0.
Dovrei continuare a usare Dockge?
Può avere ancora senso se vuoi intenzionalmente gestire uno stack Compose indipendente invece di lasciare che sia ZimaOS a gestire l’applicazione.
Posso conservare i dati esistenti dell’app passando a Custom Compose?
Spesso sì, se le cartelle persistenti sull’host vengono conservate e rimappate correttamente, ma esegui un backup dei dati e annota prima le impostazioni originali del container.
