CasaOS en ZimaOS zijn verschillende besturingssystemen. De overstap ertussen is daarom een migratie en geen upgrade ter plaatse. Bestanden, standaardappgegevens en veel Docker Compose-configuraties kunnen worden overgezet, maar systeemgebruikers, netwerkinstellingen, opslagkoppelingen, shares en sterk aangepaste containers moeten mogelijk handmatig opnieuw worden aangemaakt.
Het antwoord veranderde ook nadat de communityvraag voor het eerst was geplaatst. In juli 2025 beschreef het officiële antwoord het kopiëren van bestanden via een LAN en het handmatig opnieuw installeren van apps. In september 2025 publiceerde IceWhale een migratiehandleiding. De huidige handleiding, bijgewerkt in september 2026, voegt de CTOZ-tool toe voor het overzetten van veel CasaOS App Store-containers en hun gegevens.
Van CasaOS naar ZimaOS is een migratie, geen upgrade ter plaatse
Bij een upgrade ter plaatse zou CasaOS worden vervangen terwijl de systeemconfiguratie automatisch behouden blijft. Dat is niet het model dat door het ZimaOS-team wordt beschreven. Door ZimaOS te installeren ontstaat een andere besturingssysteemomgeving. Daarom is het veilige plan: inventariseren, een back-up maken, installeren, migreren, controleren en pas daarna de oorspronkelijke omgeving buiten gebruik stellen.
Overschrijf de enige kopie van je CasaOS-systeem niet voordat persoonlijke bestanden, applicatiegegevens, Compose-definities, inloggegevens en configuratienotities naar geverifieerde opslag zijn gekopieerd.
Leg apppaden en instellingen vast voordat je begint
Het eerste officiële antwoord adviseerde om het instellingenpaneel van elke app te openen en de bestaande mappaden vast te leggen. Dit blijft nuttig, zelfs wanneer er een geautomatiseerde migratietool beschikbaar is, omdat een container succesvol kan starten terwijl deze naar de verkeerde gegevensmap verwijst.
Leg voor elke app het volgende vast:
- Containerimage en versie.
- Paden naar volumes op de host en in de container.
- Poorten en netwerkmodus.
- Omgevingsvariabelen en gebruikers-/groeps-ID's.
- Mappen voor AppData, databases, media en configuratie.
- Handmatig aangemaakte Docker-netwerken of apparaten.
Migratie wanneer CasaOS en ZimaOS tegelijkertijd kunnen draaien
De eenvoudigste aanpak is om de CasaOS-bron en de ZimaOS-bestemming op hetzelfde LAN beschikbaar te maken. Deel de vereiste CasaOS-mappen via SMB, koppel die share in ZimaOS Bestanden en kopieer of migreer de gegevens naar de bestemmingsopslag.
Voor apps die via de CasaOS App Store zijn geïnstalleerd, raadt de huidige migratiehandleiding van CasaOS naar ZimaOS de door de community ontwikkelde CTOZ-tool aan. CTOZ kan de CasaOS AppData-map en de bijbehorende Docker Compose-YAML overzetten en vervolgens ondersteunde apps opnieuw installeren in ZimaOS.
Wat CTOZ migreert
- AppData die bij ondersteunde CasaOS-apps hoort.
- De Docker Compose-YAML die wordt gebruikt om de containers opnieuw te maken.
- Standaard appgegevens en configuratie die door deze toegewezen mappen worden gedekt.
Wat CTOZ niet automatisch migreert
- CasaOS-gebruikers en instellingen op systeemniveau.
- Netwerkconfiguratie, opslagkoppelingen en configuratie voor delen.
- Niet-standaardcontainers die buiten de CasaOS App Store zijn geïmplementeerd.
- Aangepaste wijzigingen aan de host die niet in AppData of Compose-bestanden zijn vastgelegd.
Migratie wanneer u slechts één server hebt
In de thread uit 2025 werd de lastigste topologie benadrukt: CasaOS en ZimaOS kunnen tijdens een bare-metal-herinstallatie niet naast elkaar op dezelfde server draaien. Het team stelde voor eerst bestanden naar een Windows-pc te kopiëren en deze terug te zetten nadat ZimaOS is geïnstalleerd, waarbij elke toepassing en de bijbehorende gegevens afzonderlijk worden verwerkt.
De huidige handleiding beschrijft ook export en import met CTOZ voor offline of zelfstandige situaties. Dit kan het handmatig opnieuw opbouwen van containers beperken, maar maakt onafhankelijke opslag van back-ups niet overbodig. Exporteer het materiaal van ondersteunde apps voordat u CasaOS vervangt en kopieer dit — samen met persoonlijke bestanden en een afzonderlijke registratie van de systeeminstellingen — naar een Windows-pc, externe schijf, NAS of een andere geverifieerde bestemming.
Aanbevolen volgorde voor de migratie van CasaOS naar ZimaOS
- Maak een inventaris: Noteer bestanden, shares, apps, volumes, poorten, inloggegevens, databases, gebruikers en aangepaste containers.
- Maak een back-up: Maak ten minste één geverifieerde kopie buiten de CasaOS-systeemschijf. Voor databases kan naast het kopiëren van bestanden een exportspecifieke app nodig zijn.
- Exporteer ondersteunde apps: Gebruik waar van toepassing de huidige CTOZ-workflow en bewaar de Docker Compose-YAML.
- Installeer ZimaOS: Voer de schone installatie pas uit nadat de back-up vanaf een ander apparaat kan worden geopend.
- Herstel bestanden: Kopieer persoonlijke bestanden en appgegevens naar de daarvoor bestemde opslaglocaties in ZimaOS.
- Importeer of installeer apps opnieuw: Gebruik CTOZ of de handmatige Compose-import van ZimaOS en corrigeer indien nodig de poorten en volumepaden.
- Maak de systeeminstellingen opnieuw aan: Configureer gebruikers, shares, netwerken, mounts en machtigingen in ZimaOS.
- Valideer: Open elke app, controleer de gegevens, test schrijfbewerkingen en machtigingen en controleer externe toegang voordat u de back-up verwijdert.
Als een app niet automatisch opnieuw wordt geïnstalleerd
In de huidige ZimaOS-documentatie staat dat CTOZ AppData overdraagt, zelfs wanneer de automatische installatie van containers mislukt. Als een doelmap al dezelfde naam heeft, kan de tool een nummer toevoegen in plaats van de map te overschrijven. De geëxporteerde Compose-YAML kan vervolgens handmatig via de ZimaOS App Store worden geïmporteerd.
Controleer na elke automatische migratie de instellingen van de app en verifieer dat volumepaden naar de overgezette mappen verwijzen. Een actieve container is geen voldoende bewijs dat de database, mediabibliotheek of configuratie correct is hersteld.
CLI- en niet-standaardcontainers handmatig verwerken
Containers die buiten de CasaOS App Store zijn gemaakt, vallen buiten het gedocumenteerde automatische toepassingsgebied van CTOZ. Zoek hun bind mounts, benoemde volumes, AppData, Compose-bestanden, omgevingsvariabelen en geheimen op. Implementeer na de installatie van ZimaOS de image of het Compose-project opnieuw en koppel de herstelde gegevens met de juiste hostpaden van ZimaOS.
Het opensource-CTOZ-project op GitHub bevat de broncode van de tool en de actuele installatie-informatie waarnaar de officiële handleiding verwijst.
Veelgestelde vragen over de migratie van CasaOS naar ZimaOS
Kan CasaOS rechtstreeks naar ZimaOS worden geüpgraded?
Nee. Het ZimaOS-team beschreef ze als verschillende besturingssystemen. Plan een migratie met back-ups en een schone installatie van ZimaOS in plaats van een upgrade ter plaatse.
Kunnen CasaOS-apps en hun gegevens naar ZimaOS worden verplaatst?
Veel standaardcontainers uit de CasaOS App Store kunnen met CTOZ worden gemigreerd, inclusief hun AppData en Docker Compose-YAML. Niet-ondersteunde of aangepaste containers vereisen een handmatige back-up en herimplementatie.
Heb ik twee servers nodig?
Twee gelijktijdig actieve systemen maken overdracht via het LAN en online migratie met CTOZ eenvoudiger, maar de huidige documentatie beschrijft ook exporteren/importeren voor offline of zelfstandige migratie. Bij migratie met één server is nog steeds een andere veilige locatie nodig om de back-up op te slaan terwijl CasaOS wordt vervangen.
Kan een Windows-pc dienen als tijdelijke migratiebestemming?
Ja. In het officiële community-antwoord werd aangeraden bestanden vóór de installatie van ZimaOS naar Windows te kopiëren en ze daarna terug te kopiëren. Bewaar naast persoonlijke bestanden ook appgegevens, Compose-definities en configuratierecords.
Worden CasaOS-gebruikers, koppelingen en netwerkinstellingen automatisch overgezet?
Nee. Volgens de huidige richtlijnen moeten systeemgebruikers, netwerkconfiguratie, opslagkoppelingen en shares handmatig opnieuw worden aangemaakt of gecontroleerd in ZimaOS.
Welke CasaOS-versie vereist CTOZ?
In de huidige officiële handleiding staat CasaOS 0.4.4 of hoger vermeld, omdat CTOZ afhankelijk is van de gestandaardiseerde Docker Compose-configuraties die in nieuwere CasaOS-versies worden gebruikt.
