So verschieben Sie Immich-Daten, ohne Benutzer, Verlauf oder Einstellungen zu verlieren

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Migrieren Sie Immich als Migration des Anwendungsstatus und nicht als Ordnerkopie: Bewahren Sie die Datenbank, den Medienbaum, die Konfiguration, die Secrets und die Pfade auf, die diese miteinander verknüpfen.

Eine Migration kann erfolgreich wirken, weil jede JPEG-Datei auf der neuen Festplatte vorhanden ist, während Konten, Alben, Personen, Freigaben, Favoriten oder historische Beziehungen fehlen. Richten Sie zuerst einen Rollback-Punkt ein, erfassen Sie einen konsistenten Quellstatus, kopieren Sie ihn ohne Änderung von Kennungen, stellen Sie ihn auf einem isolierten Ziel wieder her und wechseln Sie erst dann um, wenn die Abläufe im Haushalt übereinstimmen.

Den gemeinsam zu migrierenden Status erfassen

Erfassen Sie die PostgreSQL-Datenbank, hochgeladene Medien, zu erhaltende generierte Daten, Definitionen externer Bibliotheken, Compose- oder App-Konfiguration, Umgebungsvariablen, Secrets, Netzwerknamen und die aktuellen Speicherzuordnungen. Kennzeichnen Sie, welches Element maßgeblich ist und welches nach der Wiederherstellung neu erstellt werden kann.

Eine Migrationsdiskussion von 2026 über den Erhalt von Immich-Benutzern bei einem Umzug unterstreicht den zentralen Punkt: Benutzer- und Bibliotheksstatus sind an die Datenbank und eingebundene Pfade gebunden, nicht an das Container-Image. Betrachten Sie Befehle aus der Community als Beispiele und passen Sie sie an die genaue bereitgestellte Version an.

Legen Sie vor dem Umzug eine kleine Prüfliste fest: zwei Benutzer, mehrere Alben, Favoriten, geteilte Elemente, eine Person oder ein Suchergebnis, alte und aktuelle Assets sowie gegebenenfalls einen Pfad zu einer externen Bibliothek. Diese bekannten Einträge ermöglichen nach der Migration eine deutlich aussagekräftigere Validierung als der bloße Vergleich der Gesamtdateigröße.

Vor dem Kopieren einen konsistenten Wiederherstellungspunkt erstellen

Pausieren Sie neue Uploads oder planen Sie ein Wartungsfenster ein, damit sich die Quelle während der Erfassung des Migrationsstatus nicht ändert. Erstellen Sie ein datenbanknatives Backup und sichern Sie die Quellmedien und die Konfiguration. Lassen Sie die ursprüngliche Instanz nach der Erfassung unverändert, bis das Ziel erfolgreich überprüft wurde.

Der ZimaSpace-Leitfaden zur Wiederherstellung von Fotobibliothekskomponenten im Zusammenspiel erklärt, warum Originale, Katalogstatus und pfadbestimmende Konfiguration denselben kompatiblen Wiederherstellungspunkt abbilden müssen. Für eine Migration gilt dieselbe Voraussetzung.

Verwenden Sie das Live-Datenbankverzeichnis der Produktion nicht als gewöhnliches Dateikopierziel, solange es sich ändert. Wenn die Ausfallzeit kurz sein muss, verwenden Sie einen datenbanknativen Dump und eine Speichermethode, deren Erfassungsreihenfolge Sie verstehen. Wie gut sich eine Migration wiederherstellen lässt, hängt davon ab, welchen Wiederherstellungspunkt Sie haben, nicht davon, wie viele Dateien kopiert wurden.

Medien mit intakten Pfaden und Berechtigungen kopieren

Kopieren Sie den Medienbaum zum Ziel, ohne während der Migration die Ordnerstruktur zu ändern. Bewahren Sie Eigentümer, Berechtigungen, Zeitstempel und alle Dateisystemfunktionen auf, auf die Ihre Bereitstellung angewiesen ist. Wenn der im Container sichtbare Pfad gleich bleiben soll, ändern Sie die Bind-Quelle auf dem Host und behalten Sie die Zuordnung im Container bei.

Der aktuelle rsync-Migrationsablauf hebt den Archivmodus, Probeläufe, fortsetzbare Übertragungen und die Gefahren destruktiver Spiegelungsoptionen hervor. Führe vor dem Löschen einen Vergleich im Probelauf durch und überprüfe das Ziel, statt anzunehmen, dass ein abgeschlossener Befehl gleichbedeutend mit einer vollständigen Anwendungsmigration ist.

Vergleiche Dateianzahlen und -größen und überprüfe anschließend eine repräsentative Prüfsummenstichprobe mit alten Fotos, neuen Fotos, Videos und großen Dateien. Wenn aufgrund von Änderungen an der Quelle Kopierfehler oder „verschwundene Dateien“ auftreten, nimm keine Uploads mehr an und wiederhole den differenziellen Durchlauf, statt die Quelle zu löschen, um ein scheinbar sauberes Ziel zu erzwingen.

Datenbank und Konfiguration auf einem isolierten Ziel wiederherstellen

Starte das Ziel unter einem temporären Hostnamen oder in einem isolierten Netzwerk, damit mobile Clients während der Überprüfung nichts dorthin hochladen können. Binde die kopierten Medien an den erwarteten Containerpfaden ein, stelle die zugehörige Datenbank wieder her und reproduziere die für diese Version erforderliche Umgebung, Geheimnisse, Netzwerke und Proxy-Einstellungen.

Ein separater Bericht aus dem Jahr 2026 über eine gestaffelte Servermigration zeigt, warum Betreiber den neuen Host testen, bevor sie den alten außer Betrieb nehmen. Nutze solche Berichte als Anregungen für mögliche Fehler, aber lass deine bekannten Datensätze darüber entscheiden, ob die Migration den Zustand tatsächlich bewahrt hat.

Halte an, wenn das Ziel wie eine Neuinstallation geöffnet wird, fehlenden Speicher meldet oder eine destruktive Initialisierung vorschlägt. Diese Anzeichen bedeuten meist, dass die Datenbank oder die Einbindungen nicht die erwarteten sind. Korrigiere zuerst den Pfad oder das Wiederherstellungsziel. Lade keine neuen Dateien in eine leer wirkende Instanz hoch und erzeuge so nicht zwei konkurrierende Verläufe.

Erst umstellen, wenn Benutzer, Verlauf und neue Schreibvorgänge funktionieren

Melde dich mit jedem Referenzbenutzer an und überprüfe die Albumzugehörigkeit, Favoriten, Freigaben, den Such- oder Personenstatus, repräsentative Originale, Zeitstempel und die erwarteten Bibliothekszahlen. Lade anschließend ein neues Testfoto hoch und bestätige, dass es angezeigt und verarbeitet wird und einen Container-Neustart übersteht.

Ändere das Produktions-DNS oder das Proxy-Ziel erst, nachdem der isolierte Test bestanden wurde. Lass die alte Instanz gestoppt, aber wiederherstellbar, damit nicht beide Systeme gleichzeitig Schreibvorgänge annehmen können. Bewahre die Datenbanksicherung vor der Migration und die Quellmedien auf, bis der neue Host reguläre Sicherungen erstellt und mindestens einen Wiederherstellungstest bestanden hat.

Führe ein Rollback durch, wenn die Zählwerte voneinander abweichen, bekannte Beziehungen fehlen, neue Uploads auf der falschen Festplatte landen oder das Ziel nach einem Neustart ausfällt. Eskaliere den Fall mit den Versionen von Quelle und Ziel, dem Zeitstempel der Datenbanksicherung, den Einhängezuordnungen, den Kopierprotokollen, den Berechtigungsunterschieden und dem ersten fehlgeschlagenen Prüfpunkt.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.