Wann sollten Sie eine Immich-Installation neu aufsetzen, statt sie zu reparieren?

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.

Reparieren Sie Immich, wenn der Fehler klar eingegrenzt und die Integrität der persistenten Daten nachweislich gegeben ist; bauen Sie die Laufzeitumgebung neu auf, wenn die Konfigurationsabweichungen umfassend sind, sich der Dienst aber mithilfe einer verifizierten Datenbank, Medienbibliothek, Bereitstellungsdefinition und Rollback-Kopie sicher wiederherstellen lässt.

Neu aufbauen bedeutet nicht, alles zu löschen. Container und Netzwerke sind entbehrlich, während die Datenbank und die Originaldateien die Bibliothek dokumentieren. Prüfen Sie zuerst Integrität, Umfang und Reproduzierbarkeit. Wenn die einzige Datenbank oder die einzigen Fotokopien beschädigt sein könnten, sichern Sie sie und halten Sie an. Ein sauberer Neustart auf Grundlage dieser Daten kann aus einem diagnostizierbaren Vorfall einen dauerhaften Verlust machen.

Reparieren, wenn der Fehler klar eingegrenzt und reversibel ist

Reparieren Sie das System bevorzugt, wenn sich der Fehler durch einen Mount, eine Berechtigung, einen Umgebungswert, eine Abhängigkeit, einen Job oder ein festgelegtes Image erklären lässt und das System vor einer bekannten Änderung normal funktionierte. Erfassen Sie Protokolle, erstellen Sie ein Backup, ändern Sie nur diese eine Ebene und lösen Sie den Fehler erneut aus.

Ein Durchlauf stellt die ausgefallene Funktion wieder her, ohne fehlende Assets, Datenbankfehler oder neue Startwarnungen zu verursachen. Tritt derselbe Fehler nach der Neuerstellung erneut auf, liegt die Ursache möglicherweise in der Bereitstellungsdefinition oder im persistenten Zustand. Der wiederholte Austausch des Containers ist dann keine evidenzbasierte Reparatur mehr.

Eine Diskussion über Datenbankbeschädigung zeigt, wie schnell Wiederherstellungsoptionen riskant werden, wenn die Datenbank als betroffene Ebene vermutet wird. Befolgen Sie den Grundsatz, vor Reparaturen alles zu sichern, nicht etwaige unbestätigte destruktive Befehle.

Laufzeitumgebung neu aufbauen, wenn die Abweichungen nicht mehr nachvollziehbar sind

Bauen Sie die Laufzeitumgebung sauber neu auf, wenn sich Image-Versionen, Netzwerke, Umgebungswerte, Mounts und manuelle Containeränderungen nicht mehr reproduzieren lassen, verifizierte persistente Komponenten aber intakt sind. Richten Sie den Neuaufbau neben der alten Instanz mit festgelegten Versionen und isolierten Ports ein, statt sie zu löschen.

Ein Neuaufbau ist auch nach einer Kompromittierung des Hosts oder bei einer nicht unterstützten Installation mit unbekannten Änderungen angebracht, denn durch die Wiederherstellung vertrauenswürdiger Bereitstellungsgrundlagen entsteht eine neue Prüfgrenze. Ändern Sie offengelegte Zugangsdaten und prüfen Sie Backups, bevor Sie sie mit dem bereinigten Zielsystem verbinden.

Der Überblick zu selbst gehosteter App-Bereitstellung von ZimaSpace bietet einen umfassenderen Kontext zum Service-Stack; bei Immich müssen die Beziehungen zwischen Datenbank und Medien dennoch unabhängig überprüft werden.

Nicht über unsicheren persistenten Daten neu aufbauen

Brechen Sie ab, wenn Datenbank und Upload-Bibliothek möglicherweise nicht synchron sind, das einzige Backup noch nicht getestet wurde oder unklar ist, welche Kopie maßgeblich ist. Erstellen Sie Snapshots oder Klone aller Kandidaten und notieren Sie die Zeitstempel, bevor Sie versuchen, die Datenbank wiederherzustellen oder Medien abzugleichen.

Ein Unraid-Wiederherstellungs-Thread zeigt, wie schwierig die Wiederherstellung von Immich ist, wenn Backup-Komponenten und Versionen nicht zusammenpassen. Die Diskussion zu den Wiederherstellungsgrenzen spricht dafür, den Vorgang isoliert zu testen, statt die Produktionspfade zu überschreiben.

Wenn die Originale intakt, die Datenbank aber nicht wiederherstellbar ist, sichern Sie beides und dokumentieren Sie die Folgen, bevor Sie einen erneuten Import der Bibliothek in Betracht ziehen. Das ist eine Entscheidung zur Rekonstruktion von Daten, keine Routine-Reparatur. Dabei können Alben, Freigabeeinstellungen, Gesichtsdaten, Favoriten oder historische Metadaten verloren gehen.

Persistente Daten auf einem bereinigten Ziel validieren

Stellen Sie die kopierten persistenten Daten auf dem bereinigten Ziel wieder her oder binden Sie sie dort ein. Prüfen Sie anschließend Benutzer, Timeline-Einträge, Stichproben der Originale, Alben, Suche, Gesichtsdaten, externe Bibliotheken, einen neuen Upload, Jobs und ein aktuelles Datenbank-Backup. Vergleichen Sie die Ergebnisse mit den gesicherten Belegen des Quellsystems.

Vergleichen Sie die Anzahl der Datenbankeinträge mit Stichproben von Dateien aus verschiedenen Zeiträumen, von mehreren Benutzern und aus verschiedenen Medientypen. Bestätigen Sie die Pfade externer Bibliotheken, abgeleitete Jobs und einen neuen Datenbank-Dump, bevor Sie die Produktionsadresse zuweisen. Ein Anmeldebildschirm allein belegt nicht die Integrität der Daten.

Starten Sie Container und Host zweimal neu. Der Test gilt als bestanden, wenn die Mounts stabil sind, die Konfiguration reproduzierbar ist, keine Migrationsschleife auftritt und die ursprüngliche Arbeitslast funktioniert. Treten auf dem bereinigten Ziel dieselben Datenbank- oder Dateifehler erneut auf, war die Laufzeitumgebung nicht die Ursache; die sicherere Option ist dann weiterhin eine professionelle Datenrettung.

Umzug mit klarer Rollback-Grenze

Übertragen Sie die Produktionsadresse erst, wenn die isolierten Prüfungen bestanden sind, und lassen Sie das alte System während eines vereinbarten Beobachtungszeitraums ausgeschaltet, aber wiederherstellbar. Verhindern Sie, dass beide Instanzen gleichzeitig Uploads annehmen oder dieselbe Automatisierung ausführen.

Führen Sie nach dem Umzug den üblichen Ablauf für Familien-Uploads, das Durchsuchen, die Suche, das Teilen und Backups aus. Der Test gilt als bestanden, wenn Anzahl und Originale nach dem nächsten Neustart erhalten bleiben; bei Abweichungen leiten Sie den Datenverkehr zurück zum gesicherten Ziel, ohne einen der beiden Datensätze zu überschreiben.

Kehren Sie zur Reparatur oder professionellen Datenrettung zurück, wenn auf dem bereinigten Ziel dieselben Datenbank- oder Dateifehler auftreten; die Laufzeitumgebung war nicht die Ursache. Machen Sie den Umzug rückgängig, wenn sich die Anzahl oder die Originale unterscheiden. Eskalieren Sie den Fall mit Versionsangaben, Prüfsummen, Zeitstempeln der Backups, dem ersten Fehler und der genauen Grenze zwischen kopiertem und neu erstelltem Zustand.

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.