Eine sichere Immich-Migration beginnt damit, vor dem Kopieren nachzuweisen, was erhalten bleiben muss: die Fotodateien, die Datenbank und die Bereitstellungseinstellungen, durch die beides auf dem neuen Host wieder miteinander verknüpft wird.
Bei einem Homeserver entsteht das Migrationsrisiko meist dadurch, dass diese Bestandteile zu unterschiedlichen Zeitpunkten verschoben werden oder das Zielsystem mit falschen Pfaden startet. Betrachte den alten Server als Rollback-Kopie, unterbinde vermeidbare Schreibvorgänge, halte die aktuelle Version und die Speicherzuordnungen fest und übertrage dann einen geprüften Datensatz auf den neuen Rechner. Die folgende Checkliste sorgt dafür, dass der Vorgang umkehrbar bleibt, bis sich die neue Instanz anmelden kann, die ursprüngliche Bibliothek findet, Aufgaben verarbeitet und einen Neustart übersteht, ohne auf einen leeren Zustand zurückzufallen.
Quelle einfrieren und den bekannten funktionierenden Zustand festhalten
Beginne auf dem funktionierenden Server, nicht auf dem neuen. Notiere die Immich-Version, die Compose- oder App-Store-Definition, Umgebungsvariablen für Datenbank- und Speicherpfade, den Speicherort der Fotobibliothek und der Datenbank sowie alle Einbindungen externer Bibliotheken. Notiere außerdem die aktuelle Server-URL und das Benutzerkonto, mit dem du die Validierung durchführen wirst.
Diese Bestandsaufnahme soll verhindern, dass eine Migration unbemerkt zugleich zu einem Upgrade, einer Neugestaltung der Pfade und einer Netzwerkänderung wird. Halte Anwendungsversion und logisches Speicherlayout so stabil wie möglich, bis die Wiederherstellung erfolgreich getestet wurde. Versionsänderungen können vorgenommen werden, sobald das Zielsystem nachweislich funktioniert.
Stoppe oder pausiere vor dem Kopieren neue Uploads, sofern das für deinen Haushalt zumutbar ist. Wenn das nicht praktikabel ist, lege ein Zeitfenster für die Umstellung fest und plane eine abschließende kurze Synchronisierung. Am Ende dieser Phase sollte eine schriftliche Übersicht der Quellen stehen, aus der hervorgeht, wo die Originale und der Datenbankstatus liegen und welche Konfiguration dieselben Verknüpfungen wiederherstellt.
Datenbank, Dateien und Konfiguration als gemeinsamen Migrationssatz erfassen
Behandle die Datenbank und die Mediendateien als einen gemeinsamen Wiederherstellungssatz und nicht als zwei unabhängige Sicherungen. Aktuelle Backups der Immich-Datenbank enthalten Metadaten und Dateiverweise, nicht aber die Fotos oder Videos selbst. Daher muss das Datenbank-Backup zusammen mit den passenden Inhalten von UPLOAD_LOCATION und allen separat verwalteten Daten externer Bibliotheken übertragen werden.
Ein brauchbarer Migrationssatz umfasst die Dateien, den PostgreSQL-Zustand und die Konfiguration, mit der sie wieder verbunden werden. Ein vollständiger Immich-Backup-Satz enthält hochgeladene Dateien, ein unterstütztes Datenbank-Backup und die Bereitstellungskonfiguration. Wiederherstellungstests dienen dazu, die Funktionsfähigkeit des Satzes nachzuweisen. Bewahre diese Bestandteile zusammen auf, damit sich das Zielsystem einem bestimmten Wiederherstellungspunkt zuordnen lässt.
Überprüfe den Migrationssatz, bevor du das Zielsystem veränderst. Vergewissere dich, dass der Datenbank-Dump nicht leer ist, prüfe mehrere Originaldateien aus der kopierten Bibliothek und bewahre die Compose- und Umgebungsdateien im selben Migrationsordner oder in derselben Dokumentationssammlung auf. Wenn sich eine Komponente nicht überprüfen lässt, halte hier an und erstelle eine neue Kopie, statt das Problem auf dem neuen Server auszugleichen.
Neuen Host vorbereiten, ohne konkurrierende Daten anzulegen
Erstelle zuerst die Zielverzeichnisse und Mounts. Vergewissere dich dann, dass der neue Host die vorgesehenen Datenträger oder Netzwerkfreigaben an genau den geplanten Pfaden sieht. Fehlt ein NAS-Mount, kann ein gewöhnliches leeres Verzeichnis zurückbleiben, und ein Container kann problemlos auf diesem Ersatzpfad initialisiert werden.
Installiere die Laufzeitumgebung und erstelle die Bereitstellungsdefinition neu. Lass aber keine leere Immich-Instanz Uploads oder Konfiguration ansammeln, bevor der alte Zustand wiederhergestellt ist. Sorge dafür, dass Zugangsdaten, Datenbankname, Speichervariablen und Mount-Ziele externer Bibliotheken mit der Quelle übereinstimmen, sofern der Migrationsplan keine kontrollierte Pfadänderung vorsieht.
Wenn der neue Server andere Pfade auf dem Host erfordert, ordne sie gezielt zu und achte darauf, dass die im Container sichtbaren Pfade und die Erwartungen der Datenbank übereinstimmen. Das Zielsystem ist erst bereit, wenn die effektiven Mounts auf die kopierten Speicherorte verweisen und du jede Pfadzuordnung erklären kannst, bevor du die gesamte Anwendung startest.
Status wiederherstellen und alle Speicherpfade erneut verbinden
Stelle die Datenbank mithilfe des Wiederherstellungsverfahrens wieder her, das zur Immich-Version passt, mit der das Backup erstellt wurde. Starte die übrigen Dienste erst, wenn die Datenbank bereit ist. Führe keine destruktiven Datenbankbefehle aus einer älteren Anleitung aus, wenn eine neuere Installation einen anderen Wiederherstellungsablauf verwendet.
Sorge während der Umstellung dafür, dass die Beziehung zwischen Datenbank und Speicher intakt bleibt, bevor der normale Betrieb wieder aufgenommen wird. Eine getestete Immich-Migrationssequenz folgt demselben Prinzip: Die Anwendung sollte mit dem wiederhergestellten Datenbankzustand und den vorgesehenen Medienpfaden starten, statt eine neue Bibliothek zu initialisieren und einen vollständigen Neuaufbau zu erzwingen.
Prüfe nach dem Start den Speicherzugriff, bevor du ressourcenintensive Hintergrundaufgaben startest. Öffne mehrere ältere Dateien von unterschiedlichen Daten, überprüfe, ob die Vorschaubilder geladen werden, bestätige, dass ein Album und eine Person oder ein Suchergebnis vorhanden sind, die es schon vor der Migration gab, und stelle sicher, dass externe Bibliotheken lesbar sind, falls du sie verwendest. Ein neuer Einrichtungsbildschirm oder eine leere Zeitleiste ist ein Warnsignal: Überprüfe die Datenbank- und Einbindungspfade, bevor du neue Daten schreibst.
Prüfe die ursprüngliche Arbeitslast, bevor du den alten Server außer Betrieb nimmst
Eine erfolgreiche erste Anmeldung ist nicht das Ende einer Migration. Lade über den üblichen Client ein entbehrliches Testfoto hoch, bestätige, dass es im erwarteten Speicher des Hosts erscheint, lösche es dann über Immich und überprüfe, ob die Bibliothek weiterhin fehlerfrei ist. So wird der gesamte Schreibpfad geprüft, statt nur zu bestätigen, dass alte Daten lesbar sind.
Starte den neuen Home-Server neu und wiederhole die für deinen Haushalt wichtigen Prüfungen: Browser-Login, Verbindung zur mobilen Sicherung, einige ältere Fotos, Suche, ein typisches Video, Warteschlangen für Aufgaben und Fernzugriff, falls dieser zum normalen Setup gehört. Die Migration ist erst abgeschlossen, wenn derselbe Zustand einen Host-Neustart übersteht und die Speicher eingebunden sind, bevor Immich startet.
Lass den alten Server während eines Rückfallzeitraums ausgeschaltet und unverändert, statt ihn sofort zu löschen. Wenn die neue Instanz in einen unerwartet leeren Ordner zu schreiben beginnt, die alte Bibliothek nach einem Neustart nicht wiederherstellen kann oder unerklärliche Datenbankfehler anzeigt, stoppe neue Uploads und wechsle zurück zur bekannten, funktionierenden Quelle, während du den Migrationsbestand vergleichst. Nimm den alten Host erst außer Betrieb, wenn das Ziel im normalen Betrieb funktioniert und ein neuer Sicherungstest erfolgreich war.
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...



