Systemintegrität

Ordnerüberprüfungen

Info

Die Ordner, die für diese Überprüfungen berücksichtigt werden, umfassen: upload/, library/, thumbs/, encoded-video/, profile/, backups/

Beim Start von Immich führt die Anwendung eine Reihe von Überprüfungen durch, um sicherzustellen, dass sie Dateien auf den von dem Speichersystem verwendeten Volumenmounts lesen und schreiben kann. Wenn sie nicht alle erforderlichen Vorgänge ausführen kann, schlägt der Start fehl. Die Überprüfungen umfassen:

• Erstellen einer initialen versteckten Datei (.immich) in jedem Ordner
• Lesen einer versteckten Datei (.immich) in jedem Ordner
• Überschreiben einer versteckten Datei (.immich) in jedem Ordner

Die Überprüfungen sind darauf ausgelegt, folgende Situationen zu erkennen:

• Falsche Berechtigungen (kann Dateien nicht lesen/schreiben)
• Fehlender Volumenmount (.immich-Dateien sollten vorhanden sein, fehlen jedoch)

Häufige Probleme

Notiz

.immich-Dateien dienen als Marker und helfen, die von Immich verwendeten Volumenmounts zu verfolgen. Außer in den unten aufgeführten Situationen sollten sie niemals manuell erstellt oder gelöscht werden.

Fehlende .immich-Dateien

Systemmount-Ordnerüberprüfungen werden überprüft (aktiviert=true)
...
ENOENT: Datei oder Verzeichnis nicht gefunden, öffnen 'upload/encoded-video/.immich'

Die obigen Fehlermeldungen zeigen, dass der Server zuvor (erfolgreich) .immich-Dateien in jedem Ordner geschrieben hat, diese jedoch jetzt nicht erkennt. Dies könnte durch Folgendes verursacht werden:

• Berechtigungsfehler - Datei kann nicht gelesen werden, ist aber vorhanden
• Datei existiert nicht - Volumenmount wurde geändert und sollte korrigiert werden
• Datei existiert nicht - Benutzer hat sie manuell gelöscht und sollte sie manuell wiederherstellen (touch .immich)
• Datei existiert nicht - Benutzer hat aus einem Backup wiederhergestellt, jedoch nicht jeden Ordner wiederhergestellt (Benutzer sollte alle Ordner wiederherstellen oder .immich manuell in allen fehlenden Ordnern erstellen)

Die Überprüfungen ignorieren

Warnung

Die Überprüfungen sind darauf ausgelegt, häufige Probleme zu erkennen, die Benutzer in der Vergangenheit hatten, und deuten oft darauf hin, dass es ein Problem gibt, das Sie lösen sollten. Wenn Sie wissen, was Sie tun, und diese deaktivieren möchten, können Sie folgende Umgebungsvariable setzen:

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true