Wenn Immich nach der Neuerstellung des Stacks leer wirkt oder die Bibliothek nicht lesen kann, gehen Sie zunächst davon aus, dass die alten persistenten Daten nicht verbunden oder nicht lesbar sind, bevor Sie annehmen, dass sie gelöscht wurden.
Beim Neuerstellen von Containern können sich die Compose-Projektidentität, die Quelle des Bind-Mounts, die Einbindung eines benannten Volumes, der Zeitpunkt der Einbindung einer Netzwerkfreigabe oder die UID/GID für den Datenzugriff ändern. Stoppen Sie die frisch wirkende Instanz, bevor sie viele neue Daten schreibt, suchen Sie die alten Datenbank- und Medienpfade auf dem Host und vergleichen Sie den neu erstellten Stack mit der letzten bekannten funktionierenden Zuordnung. Ziel ist es, zuerst den Zugriff auf den vorhandenen Datenbestand wiederherzustellen; stellen Sie erst dann ein Backup wieder her, wenn Sie nachgewiesen haben, dass dieser Datenbestand tatsächlich fehlt oder beschädigt ist.
Die neue Instanz stoppen und nachweisen, dass die alten Daten noch vorhanden sind
Ein Einrichtungsassistent, eine leere Timeline oder eine fehlende externe Bibliothek unmittelbar nach der Neuerstellung ist ein Warnzeichen für ein Persistenzproblem. Stoppen Sie Immich und prüfen Sie die Datenbank- und Medienpfade auf dem Host, bevor Sie neue Dateien hochladen oder eine neue, leere Konfiguration übernehmen. Neue Schreibvorgänge können spätere Pfadvergleiche erschweren.
Prüfen Sie in den alten Verzeichnissen die erwartete Anzahl von Dateien, Änderungsdaten, Datenbankdateien oder Dumps sowie repräsentative Originalbilder. Sind die Daten auf dem Host vorhanden, liegt das Problem beim Zugriff oder bei der Zuordnung und nicht beim Verschwinden der Daten. Erstellen Sie einen schreibgeschützten Snapshot oder ein Backup dieses Datenbestands, bevor Sie Berechtigungen ändern oder Verzeichnisse verschieben.
Wenn die alten Daten nicht an den erwarteten Pfaden zu finden sind, durchsuchen Sie vor dem Löschen den Speicherpool und das Docker-Volume-Inventar. Die Entscheidung ist eindeutig: Entweder wird der vorhandene Datenbestand gefunden und geschützt, oder er ist tatsächlich nicht verfügbar und die Wiederherstellung erfolgt aus einem verlässlichen Backup statt durch Reparaturen an den Mounts.
Die neu erstellten Mounts mit dem vorherigen Stack vergleichen
Prüfen Sie die tatsächlich eingebundenen Mounts der neu erstellten Immich- und Datenbank-Container, nicht nur den Compose-Text, an dessen Bearbeitung Sie sich erinnern. Ein relativer Bind-Pfad kann sich von einem anderen Projektverzeichnis aus auflösen, und ein umbenanntes Compose-Projekt kann ein neues benanntes Volume einbinden, während das alte intakt, aber ungenutzt bleibt.
Ein fehlgeschlagener, geänderter oder fehlender Mount kann im Container ein leeres Verzeichnis anzeigen, obwohl die erwarteten Daten an anderer Stelle auf dem Host noch vorhanden sind. Verwende Docker-Prüfungen für Volume-Mounts, um für jeden persistenten Immich-Pfad Quelle, Ziel, Mount-Typ und Identität des benannten Volumes abzugleichen. Eine Abweichung an dieser Stelle erklärt direkt, warum die Instanz wie frisch eingerichtet aussieht.
Korrigiere nur die fehlerhafte Mount-Zuordnung und erstelle oder starte den Container anschließend, ohne Volumes zu entfernen. Wenn die erwarteten Dateien nach der Änderung am selben Container-Pfad erscheinen, belasse die Daten dort. Wenn die Mount-Liste stimmt, der Zugriff aber weiterhin fehlschlägt, behalte die Zuordnung bei und prüfe die Verfügbarkeit und Berechtigungen des Host-Speichers, statt ein weiteres Volume zu erstellen.
Überprüfen, ob der externe Speicher vor dem Start von Immich eingebunden wurde
Wenn Immich-Daten auf einem HDD-Verbund, einer NAS-Freigabe, einer Merger-Ebene oder einem anderen externen Mount liegen, stelle sicher, dass dieser Speicher auf dem Host tatsächlich eingebunden ist, bevor Docker den Stack startet. Ein Pfad wie /mnt/photos kann weiterhin als gewöhnliches lokales Verzeichnis vorhanden sein, wenn das eigentliche Gerät fehlt.
Persistente Docker-Daten überstehen den Austausch eines Containers nur dann, wenn das vorgesehene Volume oder der Bind-Mount korrekt erneut eingebunden wird. Das zugrunde liegende Persistenzmodell von Docker-Volumes sorgt nicht dafür, dass eine fehlende Host-Festplatte oder Netzwerkfreigabe automatisch verfügbar wird. Überprüfe daher das Speichergerät und eine bekannte Datei auf dem Host, bevor du denselben Pfad in Immich testest.
Wenn du feststellst, dass Fallback-Dateien in den leeren Einhängepunkt geschrieben wurden, während der eigentliche Speicher nicht verfügbar war, stoppe Immich, bevor du das Gerät darüber einhängst. Gleiche diese Dateien separat ab, füge eine Startabhängigkeit oder eine Zustandsprüfung für die Speichereinbindung hinzu und starte erst dann den Stack neu. Wenn der Host-Speicher stabil ist und der Container-Pfad weiterhin nicht lesbar ist, fahre mit der Berechtigungsprüfung fort.
UID, GID und Verzeichnisberechtigungen prüfen, ohne alles neu zu schreiben
Ein neu erstellter Stack kann einen Dienst mit einer anderen numerischen Benutzerkennung, einem anderen User-Namespace oder einem anderen Sicherheitskontext als zuvor ausführen. Das unterscheidet sich von einem fehlenden Mount: Der Pfad ist vorhanden und die Dateien sind auf dem Host sichtbar, aber die Immich-Protokolle zeigen Berechtigungsfehler oder der Dienst kann erwartete Dateien nicht erstellen.
Vergleiche den numerischen Eigentümer und die Modus-Bits der betroffenen Host-Verzeichnisse mit der Benutzerkennung im neu erstellten Container. Teste zuerst einen unbedenklichen Lesezugriff und anschließend einen rückgängig machbaren Schreibzugriff an einem entbehrlichen Speicherort innerhalb desselben Mounts. Ändere nicht rekursiv die Eigentümerschaft des gesamten Fotoarchivs, bevor du weißt, welcher Dienst Schreibzugriff benötigt und welche Originaldateien unverändert bleiben sollen.
Behebe die kleinstmögliche Abweichung bei Verzeichnis oder Benutzerkennung, die den Fehler erklärt, starte den Dienst einmal neu und überprüfe die Protokolle erneut. Wenn der Zugriff trotz passender Mounts und Berechtigungen weiterhin fehlschlägt, nimm keine weiteren Änderungen am Dateisystem vor und untersuche die Datenbankverbindung, die Ersetzung von Umgebungsvariablen oder die Sicherheitsebene, die sich beim Neuaufbau geändert hat.
Ursprünglichen Datenbestand erneut verbinden und einen weiteren Neuaufbau überprüfen
Sobald die alten Datenbank- und Medienpfade eingebunden und lesbar sind, starte Immich und prüfe, ob die alten Benutzer, Alben, Personen und repräsentativen Dateien angezeigt werden. Betrachte die Reparatur nicht als abgeschlossen, nur weil die Startseite geladen wird; vergewissere dich, dass die Anwendung den ursprünglichen Datenbestand verwendet und nicht eine daneben neu initialisierte Datenbank.
Entscheidend ist, dass Container entbehrlich sein können, während Anwendungsdaten auf einem stabilen Speicher außerhalb des Lebenszyklus des Containers bleiben müssen. Dokumentiere die korrigierten Mount-Namen und Host-Pfade und nutze persistente Speicherrollen für Dateiserver, damit der nächste Stack-Neuaufbau wieder mit denselben Daten verbunden ist.
Erstelle den Stack unter kontrollierten Bedingungen ein letztes Mal neu und wiederhole die ursprünglichen Prüfungen. Die Fehlerbehebung gilt nur dann als nachgewiesen, wenn dieselbe Datenbank und dieselben Medien nach der Neuerstellung und nach einem Neustart des Hosts wieder vorhanden sind. Wenn der alte Datenbestand erneut verschwindet oder die Datenbank statt Zugriffsfehlern eine Beschädigung meldet, stelle die geschützte Kopie wieder her und wechsle zur Datenbank- beziehungsweise Backup-Wiederherstellung, statt weitere Mount-Experimente durchzuführen.
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...



