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

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



