CasaOS och ZimaOS är olika operativsystem, så en flytt mellan dem är en migrering snarare än en uppgradering på plats. Filer, standardiserad appdata och många Docker Compose-konfigurationer kan överföras, men systemanvändare, nätverksinställningar, lagringsmonteringar, utdelningar och djupt anpassade containrar kan behöva återskapas manuellt.
Svaret ändrades också efter att community-frågan först publicerades. I juli 2025 beskrev det officiella svaret hur filer skulle kopieras över ett LAN och appar installeras om manuellt. I september 2025 hade IceWhale publicerat en migreringsguide. Den aktuella guiden, uppdaterad i september 2026, lägger till verktyget CTOZ för att överföra många CasaOS App Store-containrar och deras data.
CasaOS till ZimaOS är en migrering, inte en uppgradering på plats
En uppgradering på plats skulle ersätta CasaOS men automatiskt bevara systemkonfigurationen. Det är inte den modell som ZimaOS-teamet beskriver. När ZimaOS installeras skapas en annan operativsystemmiljö, så den säkra planen är att inventera, säkerhetskopiera, installera, migrera, verifiera och först därefter avveckla den ursprungliga miljön.
Skriv inte över den enda kopian av ditt CasaOS-system förrän personliga filer, appdata, Compose-definitioner, autentiseringsuppgifter och konfigurationsanteckningar har kopierats till verifierad lagring.
Dokumentera appsökvägar och inställningar innan du börjar
Det första officiella svaret rekommenderade att öppna inställningspanelen för varje app och dokumentera de befintliga mappsökvägarna. Detta är fortfarande användbart även när ett automatiserat migreringsverktyg finns tillgängligt, eftersom en container kan starta korrekt men ändå peka på fel datakatalog.
Dokumentera följande för varje app:
- Containeravbildning och version.
- Volymsökvägar på värden och i containern.
- Portar och nätverksläge.
- Miljövariabler samt användar- och grupp-ID:n.
- AppData-, databas-, medie- och konfigurationsmappar.
- Alla manuellt skapade Docker-nätverk eller enheter.
Migrering när CasaOS och ZimaOS kan köras samtidigt
Det enklaste sättet är att hålla CasaOS-källan och ZimaOS-destinationen tillgängliga på samma LAN. Dela de nödvändiga CasaOS-mapparna via SMB, montera resursen i ZimaOS Filer och kopiera eller migrera data till destinationslagringen.
För appar som installerats via CasaOS App Store rekommenderar den aktuella migreringsguiden från CasaOS till ZimaOS verktyget CTOZ, som utvecklats av communityn. CTOZ kan överföra CasaOS AppData-katalogen och motsvarande Docker Compose YAML-fil och sedan installera om appar som stöds i ZimaOS.
Vad CTOZ migrerar
- AppData som hör till CasaOS-appar som stöds.
- Docker Compose YAML-filen som används för att återskapa containrarna.
- Standardiserad appdata och konfiguration som täcks av de mappningar som anges.
Vad CTOZ inte migrerar automatiskt
- CasaOS-användare och inställningar på systemnivå.
- Nätverkskonfiguration, lagringsmonteringar och delningskonfiguration.
- Icke-standardiserade containrar som distribuerats utanför CasaOS App Store.
- Anpassningar av värdsystemet som inte finns representerade i AppData eller Compose-filer.
Migrering när du bara har en server
Tråden från 2025 lyfte fram den mest krävande topologin: CasaOS och ZimaOS kan inte köras sida vid sida på samma server under en ominstallation på fysisk maskinvara. Teamet föreslog att först kopiera filerna till en Windows-dator och återföra dem efter att ZimaOS har installerats, med varje app och dess data hanterade individuellt.
Den aktuella guiden beskriver även CTOZ-export och -import för offline- eller fristående situationer. Detta kan minska behovet av att återskapa containrar manuellt, men eliminerar inte behovet av oberoende säkerhetskopiering. Innan du ersätter CasaOS exporterar du materialet för appar som stöds och kopierar det – tillsammans med personliga filer och ett separat register över systeminställningarna – till en Windows-dator, extern disk, NAS eller annan verifierad destination.
Rekommenderad ordning för migrering från CasaOS till ZimaOS
- Inventera: Lista filer, delningar, appar, volymer, portar, inloggningsuppgifter, databaser, användare och anpassade containrar.
- Säkerhetskopiera: Skapa minst en verifierad kopia utanför CasaOS-systemdisken. Databaser kan kräva appspecifika exporter utöver filkopiering.
- Exportera appar som stöds: Använd det aktuella CTOZ-arbetsflödet där det är tillämpligt och spara Docker Compose YAML-filen.
- Installera ZimaOS: Genomför den rena installationen först när säkerhetskopian kan öppnas från en annan enhet.
- Återställ filer: Kopiera personliga filer och appdata till deras avsedda lagringsplatser i ZimaOS.
- Importera eller installera om appar: Använd CTOZ eller ZimaOS manuella Compose-import och korrigera sedan portar och volymsökvägar efter behov.
- Återskapa systeminställningar: Konfigurera användare, delningar, nätverk, monteringar och behörigheter i ZimaOS.
- Verifiera: Öppna varje app, bekräfta dess data, testa skrivningar och behörigheter och kontrollera fjärråtkomst innan du raderar säkerhetskopian.
Om en app inte installeras om automatiskt
Den aktuella ZimaOS-dokumentationen säger att CTOZ överför AppData även när den automatiserade containerinstallationen misslyckas. Om en målmapp redan har samma namn kan verktyget lägga till ett nummer i stället för att skriva över den. Den exporterade Compose-YAML-filen kan sedan importeras manuellt via ZimaOS App Store.
Efter en automatiserad migrering ska du granska appens inställningar och kontrollera att volymsökvägarna pekar på de överförda mapparna. Att en container körs är inte tillräckligt bevis på att dess databas, mediebibliotek eller konfiguration har återställts korrekt.
Hantera CLI- och icke-standardcontainrar manuellt
Containrar som skapats utanför CasaOS App Store omfattas inte av CTOZ:s dokumenterade automatiska funktioner. Leta reda på deras bind-monteringar, namngivna volymer, AppData, Compose-filer, miljövariabler och hemligheter. När ZimaOS har installerats distribuerar du avbildningen eller Compose-projektet på nytt och kopplar den återställda datan till rätt värdsökvägar i ZimaOS.
Projektet CTOZ på GitHub med öppen källkod tillhandahåller verktygets källkod och aktuell installationsinformation som den officiella guiden hänvisar till.
Vanliga frågor om migrering från CasaOS till ZimaOS
Kan CasaOS uppgraderas direkt till ZimaOS?
Nej. ZimaOS-teamet beskrev dem som olika operativsystem. Planera en migrering med säkerhetskopior och en ren installation av ZimaOS i stället för en uppgradering på plats.
Kan CasaOS-appar och deras data flyttas till ZimaOS?
Många standardcontainrar från CasaOS App Store kan migreras med CTOZ, inklusive deras AppData och Docker Compose-YAML. Containrar som inte stöds eller anpassade containrar kräver manuell säkerhetskopiering och återdistribution.
Behöver jag två servrar?
Två system som körs samtidigt gör överföring via LAN och CTOZ-migrering online enklare, men den aktuella dokumentationen beskriver också export/import för offline- eller fristående migrering. En migrering med en enda server kräver fortfarande en annan säker plats för säkerhetskopian medan CasaOS ersätts.
Kan en Windows-dator fungera som tillfällig migreringsdestination?
Ja. Det officiella community-svaret föreslog att filer kopieras till Windows innan ZimaOS installeras och sedan kopieras tillbaka. Bevara appdata, Compose-definitioner och konfigurationsposter samt personliga filer.
Överförs CasaOS-användare, monteringar och nätverksinställningar automatiskt?
Nej. Den aktuella vägledningen säger att systemanvändare, nätverkskonfiguration, lagringsmonteringar och delningar måste återskapas eller kontrolleras manuellt i ZimaOS.
Vilken CasaOS-version kräver CTOZ?
Den aktuella officiella guiden anger CasaOS 0.4.4 eller senare eftersom CTOZ är beroende av de standardiserade Docker Compose-konfigurationer som används av nyare CasaOS-versioner.
