CasaOS e ZimaOS sono sistemi operativi diversi, quindi il passaggio dall’uno all’altro è una migrazione anziché un aggiornamento sul posto. È possibile trasferire file, dati standard delle app e molte configurazioni Docker Compose, ma potrebbe essere necessario ricreare manualmente gli utenti di sistema, le impostazioni di rete, i punti di montaggio dello spazio di archiviazione, le condivisioni e i container fortemente personalizzati.
La risposta è cambiata anche dopo la pubblicazione iniziale della domanda della community. A luglio 2025, la risposta ufficiale descriveva la copia dei file tramite LAN e la reinstallazione manuale delle app. A settembre 2025, IceWhale aveva pubblicato una guida alla migrazione. La guida attuale, aggiornata a settembre 2026, aggiunge lo strumento CTOZ per trasferire molti container dell’App Store di CasaOS e i relativi dati.
Da CasaOS a ZimaOS: una migrazione, non un aggiornamento sul posto
Un aggiornamento sul posto sostituirebbe CasaOS preservandone automaticamente la configurazione di sistema. Questo non è il modello descritto dal team di ZimaOS. L’installazione di ZimaOS crea un ambiente operativo diverso, quindi il piano sicuro consiste nel fare l’inventario, eseguire il backup, installare, migrare, verificare e solo in seguito dismettere l’ambiente originale.
Non sovrascrivere l’unica copia del tuo sistema CasaOS finché i file personali, i dati delle applicazioni, le definizioni Compose, le credenziali e le note di configurazione non sono stati copiati in uno spazio di archiviazione verificato.
Annota i percorsi e le impostazioni delle app prima di iniziare
La prima risposta ufficiale consigliava di aprire il pannello delle impostazioni di ogni app e annotare i percorsi delle cartelle esistenti. Questo resta utile anche quando è disponibile uno strumento di migrazione automatica, perché un container può avviarsi correttamente pur puntando alla directory dati sbagliata.
Per ogni app, annota:
- Immagine e versione del container.
- Percorsi dei volumi sull’host e nel container.
- Porte e modalità di rete.
- Variabili d’ambiente e ID utente/gruppo.
- Cartelle AppData, database, contenuti multimediali e configurazione.
- Eventuali reti Docker o dispositivi creati manualmente.
Migrazione quando CasaOS e ZimaOS possono essere eseguiti contemporaneamente
Il percorso più semplice consiste nel mantenere disponibili sulla stessa LAN la sorgente CasaOS e la destinazione ZimaOS. Condividi le cartelle CasaOS necessarie tramite SMB, monta la condivisione in File di ZimaOS e copia o migra i dati nello spazio di archiviazione di destinazione.
Per le app installate tramite l'App Store di CasaOS, l'attuale guida alla migrazione da CasaOS a ZimaOS consiglia lo strumento CTOZ sviluppato dalla community. CTOZ può trasferire la directory AppData di CasaOS e il file YAML di Docker Compose corrispondente, quindi reinstallare le app supportate in ZimaOS.
Cosa migra CTOZ
- AppData associati alle app CasaOS supportate.
- File YAML di Docker Compose utilizzato per ricreare i container.
- Dati e configurazione standard delle app coperti da quelle cartelle mappate.
Cosa non migra automaticamente CTOZ
- Utenti CasaOS e impostazioni a livello di sistema.
- Configurazione di rete, montaggi di archiviazione e configurazione delle condivisioni.
- Container non standard distribuiti al di fuori dell'App Store di CasaOS.
- Modifiche personalizzate dell'host che non sono rappresentate nei file AppData o Compose.
Migrazione quando hai un solo server
La discussione del 2025 ha evidenziato la topologia più complessa: CasaOS e ZimaOS non possono essere eseguiti affiancati sullo stesso server durante una reinstallazione bare metal. Il team ha suggerito di copiare prima i file su un PC Windows e di riportarli dopo l'installazione di ZimaOS, gestendo singolarmente ogni applicazione e i relativi dati.
La guida attuale descrive anche l'esportazione/importazione tramite CTOZ per le situazioni offline o autonome. Ciò può ridurre la necessità di ricreare manualmente i container, ma non elimina la necessità di archiviare i backup separatamente. Prima di sostituire CasaOS, esporta il materiale delle app supportate e copialo, insieme ai file personali e a un registro separato delle impostazioni di sistema, su un PC Windows, un disco esterno, un NAS o un'altra destinazione verificata.
Ordine consigliato per la migrazione da CasaOS a ZimaOS
- Crea un inventario: Elenca file, condivisioni, app, volumi, porte, credenziali, database, utenti e container personalizzati.
- Esegui il backup: Crea almeno una copia verificata al di fuori del disco di sistema di CasaOS. I database potrebbero richiedere esportazioni specifiche dell'app oltre alla copia dei file.
- Esporta le app supportate: Usa il flusso di lavoro CTOZ attuale, ove applicabile, e conserva il file YAML di Docker Compose.
- Installa ZimaOS: Esegui l'installazione pulita solo dopo aver verificato che il backup possa essere aperto da un altro dispositivo.
- Ripristina i file: Copia i file personali e i dati delle app nelle posizioni di archiviazione previste da ZimaOS.
- Importa o reinstalla le app: Usa CTOZ o l'importazione manuale di Compose in ZimaOS, quindi correggi le porte e i percorsi dei volumi secondo necessità.
- Ricrea le impostazioni di sistema: Configura utenti, condivisioni, rete, montaggi e permessi in ZimaOS.
- Convalida: Apri ogni app, verifica i dati, prova le operazioni di scrittura e i permessi e controlla l'accesso remoto prima di eliminare il backup.
Se un'app non viene reinstallata automaticamente
La documentazione attuale di ZimaOS afferma che CTOZ trasferisce gli AppData anche quando l’installazione automatica del container non riesce. Se una cartella di destinazione ha già lo stesso nome, lo strumento può aggiungere un numero invece di sovrascriverla. Il file YAML Compose esportato può quindi essere importato manualmente tramite l’App Store di ZimaOS.
Dopo qualsiasi migrazione automatica, controlla le impostazioni dell’app e verifica che i percorsi dei volumi puntino alle cartelle trasferite. Un container in esecuzione non è una prova sufficiente del corretto ripristino del database, della libreria multimediale o della configurazione.
Gestisci manualmente i container CLI e non standard
I container creati al di fuori dell’App Store di CasaOS non rientrano nell’ambito dell’automazione documentato per CTOZ. Individua i relativi bind mount, volumi denominati, AppData, file Compose, variabili d’ambiente e segreti. Dopo aver installato ZimaOS, distribuisci nuovamente l’immagine o il progetto Compose e collega i dati ripristinati utilizzando i percorsi host corretti di ZimaOS.
Il progetto CTOZ open source su GitHub fornisce il codice sorgente dello strumento e le informazioni di installazione attuali a cui fa riferimento la guida ufficiale.
FAQ sulla migrazione da CasaOS a ZimaOS
È possibile aggiornare direttamente CasaOS a ZimaOS?
No. Il team di ZimaOS li ha descritti come sistemi operativi diversi. Pianifica la migrazione con backup e un’installazione pulita di ZimaOS, anziché un aggiornamento sul posto.
È possibile spostare le app di CasaOS e i relativi dati su ZimaOS?
Molti container standard dell’App Store di CasaOS possono essere migrati con CTOZ, inclusi i relativi AppData e file YAML Docker Compose. I container non supportati o personalizzati richiedono un backup e una nuova distribuzione manuali.
Ho bisogno di due server?
Due sistemi in esecuzione contemporaneamente facilitano il trasferimento sulla LAN e la migrazione online con CTOZ, ma la documentazione attuale descrive anche l’esportazione e l’importazione per la migrazione offline o autonoma. Una migrazione con un solo server richiede comunque un altro luogo sicuro in cui conservare il backup mentre CasaOS viene sostituito.
Un PC Windows può fungere da destinazione temporanea per la migrazione?
Sì. La risposta ufficiale della community suggeriva di copiare i file su Windows prima di installare ZimaOS e di ricopiarli successivamente. Conserva i dati delle app, le definizioni Compose e i record di configurazione, oltre ai file personali.
Gli utenti, i montaggi e le impostazioni di rete di CasaOS verranno trasferiti automaticamente?
No. Le indicazioni attuali affermano che gli utenti di sistema, la configurazione di rete, i montaggi di archiviazione e le condivisioni devono essere ricreati o verificati manualmente in ZimaOS.
Quale versione di CasaOS richiede CTOZ?
La guida ufficiale attuale specifica CasaOS 0.4.4 o versioni successive, poiché CTOZ dipende dalle configurazioni Docker Compose standardizzate utilizzate dalle versioni più recenti di CasaOS.
