CasaOS zu ZimaOS umziehen: So migrierst du deine Docker-Apps einfach und sicher

Schluss mit CasaOS! Ich zeige Dir, wie Du Deine Docker-Container sicher nach ZimaOS umziehst – auf derselben Hardware, ohne CTOZ und ohne Angst um Deine Daten.

Du hast CasaOS auf deinem NAS oder Home-Server laufen, alles ist eingerichtet, deine Docker-Container wie Home Assistant, Paperless NGX oder Uptime Kuma schnurren vor sich hin – und plötzlich hörst du, dass CasaOS unsupported ist. Kein Support mehr, Sicherheitslücken, und du denkst: „Mist, ich muss umziehen, aber wie? Was passiert mit meinen Daten? Brauche ich ein zweites Gerät? Verliere ich alles?“ Ich war da genau wie du.

In diesem ausführlichen Guide zeige ich dir Schritt für Schritt, wie du von CasaOS zu ZimaOS umziehst. Und das Beste: Du kannst das auf demselben Gerät machen, ohne extra Hardware. Am Ende dieses Beitrags wirst du verstehen, was genau mit deinen Daten passiert, und die Angst vor dem Umzug ist weg.

Verstehe den Prozess: Was passiert wirklich beim Umzug?

Eine der größten Ängste beim Wechsel: „Verliere ich meine Konfigurationen? Was ist mit meinen Backups?“ Lass mich das aufklären. In Docker-basierten Systemen wie CasaOS und ZimaOS sind deine Apps nicht magisch – sie bestehen aus zwei Hauptteilen:

• Das App-Verzeichnis: Hier liegen alle Daten, Configs, Datenbanken und Dateien deiner App. Zum Beispiel bei Home Assistant: Deine Automatisierungen, Integrationen und Historie sind im „config“-Ordner gespeichert.
• Die YAML-Datei: Das ist die „Blaupause“ deiner App. Sie definiert Ports, Volumes (Pfad-Mappings), Umgebungsvariablen und mehr. Exportierst du die, hast du die exakte Konfiguration.

Zusammen: Verzeichnis + YAML = 100% deiner App. Beim Umzug kopierst du einfach den Ordner und passt die YAML an den neuen Pfad an. Keine Daten werden überschrieben oder verloren – es ist wie ein Umzug deines Hauses: Du packst die Kisten (Ordner) und stellst sie am neuen Ort (ZimaOS) wieder auf. Ich hab’s früher nicht gecheckt und dachte, ich brauche komplizierte Backups. Aber nein: Docker macht’s einfach. Solange du den Container stoppst, bevor du kopierst, ist alles konsistent. Kein Risiko!

Es gibt zwar Tools wie CTOZ, die eine „One-Click-Migration“ versprechen, aber wenn es um meine Daten geht, bin ich lieber selbst am Steuer. In diesem Beitrag zeige ich Dir, wie ich meine Docker-Container ganz einfach manuell von CasaOS nach ZimaOS umgezogen habe – auf derselben Hardware und mit dem guten Gefühl, genau zu wissen, was passiert. Außerdem gibt es bei CTOZ wohl eine 500MB Import Grenze, was bei vielen Apps sehr schnell an Grenzen stößt.

Und bei mir ging es tatsächlich auch wegen der 500MB Grenze nicht

Vergiss also das Tool und mache die Migration selbst! Das geht wirklich einfach, ich zeige Dir in diesem Video Schritt für Schritt wie:

Schritt-für-Schritt Videoanleitung

Schritt-für-Schritt: So ziehst Du Deine Apps um

Da wir ZimaOS auf demselben Gerät installieren, auf dem aktuell noch CasaOS läuft, müssen wir Deine Daten kurzzeitig „zwischenparken“.

1. Vorbereitung in CasaOS

Bevor Du irgendetwas kopierst, musst Du die entsprechende App stoppen. Das ist extrem wichtig, damit die Datenbanken während des Kopierens nicht aktiv sind.

• Gehe in CasaOS auf die App-Einstellungen.
• Exportiere die YAML-Datei und speichere sie sicher auf Deinem Computer.
• Stoppe den Container.

2. Daten sichern (Das Zwischenparken)

Da wir die interne Festplatte für die ZimaOS-Installation komplett neu formatieren werden, müssen die App-Daten kurzzeitig vom Gerät runter.

• Verbinde ein Netzlaufwerk (SMB) oder eine USB-Festplatte mit Deinem CasaOS.
• Gehe in den Dateimanager zu Deinem AppData-Verzeichnis (meistens dort, wo Deine Apps wie Home Assistant oder Paperless liegen).
• Kopiere den kompletten Ordner der App auf Dein externes Laufwerk.

3. ZimaOS installieren

Jetzt wird reiner Tisch gemacht. Installiere ZimaOS auf Deinem Gerät. Ich habe dazu bereits ein ausführliches Video gemacht, wie Du den Boot-Stick erstellst und das System aufspielst.

Achtung: Dabei werden alle Daten auf der internen Platte gelöscht – aber wir haben ja unser Backup auf dem USB-Stick oder Netzlaufwerk.

4. Die Wiederherstellung in ZimaOS

Sobald ZimaOS läuft, bringen wir Deine Apps zurück nach Hause.

• Verbinde Dein externes Laufwerk oder Netzlaufwerk wieder mit ZimaOS.
• Kopiere den gesicherten App-Ordner (z.B. Home Assistant) zurück in den lokalen AppData-Ordner von ZimaOS.
• Klicke im ZimaOS Dashboard auf das „+“ oben rechts und wähle „Custom App“ (Benutzerdefinierte App installieren).
• Wähle „Import“ und lade Deine zuvor gespeicherte YAML-Datei hoch.

5. Der entscheidende Pfad-Trick

In der YAML-Datei stehen noch die alten Pfade von CasaOS. Damit die App Deine Daten wiederfindet, musst Du in der Konfiguration den Pfad auf Dein aktuelles Verzeichnis in ZimaOS anpassen.

• Suche in der Konfiguration nach dem Pfad für /config oder /data.
• Ändere den Pfad so ab, dass er genau auf den Ordner zeigt, den Du gerade in den AppData-Ordner von ZimaOS kopiert hast.
• Klicke auf „Installieren“.

Häufige Fehler und Tipps: So vermeidest du Stolpersteine

• Pfad-Fehler: Doppelcheck die Volumes der YAML in den App-Eigenschaften beim Import dreifach– ein Tippfehler und’s startet nicht.
• Angst vor Verlust: Mach Screenshots der Einstellungen und Ordner-Struktur.

Ich hab’s für all meine Apps gemacht: Paperless, Uptime Kuma, Duplicati – läuft perfekt!

Fazit: Volle Kontrolle statt Blackbox

Das war’s! Deine App startet jetzt in ZimaOS mit exakt den Einstellungen und Daten, die Du vorher in CasaOS hattest. Der große Vorteil dieses Weges: Du hast keine Angst mehr vor Systemwechseln, weil Du jetzt weißt, dass Deine ganze Magie nur aus einem Ordner und einer Textdatei besteht.

Egal ob Home Assistant, Paperless-ngx oder Uptime Kuma – das Prinzip ist immer das gleiche.