So konfigurierst du Cache und temporären Speicher von Immich

Eva Wong

IceWhale author

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

How to Configure Immich Cache and Temporary Storage - Zima Store Online

Konfigurieren Sie den Cache und den temporären Speicher von Immich, indem Sie zunächst den dauerhaften Bibliotheksstatus von generierten Ableitungen, wiederverwendbarem Modell-Cache und tatsächlich entbehrlichen temporären Containerdaten trennen.

Vorschaubilder und kodierte Videos mögen wie Cache wirken, weil Immich sie neu erzeugen kann. Sie sind jedoch dauerhafte Arbeitsdaten, die groß werden und deren Neuerstellung kostspielig sein kann. Modelldownloads haben einen anderen Lebenszyklus, während Protokolle und temporäre Daten in beschreibbaren Ebenen nicht unbemerkt die Boot-Disk belegen sollten. Weisen Sie den Speicher nach Rolle zu und testen Sie anschließend das Bereinigungs- und Neustartverhalten.

Klassifizieren Sie jede Speicherrolle, bevor Sie sie verschieben

Erstellen Sie ein Inventar mit mindestens vier Klassen: Originale und erforderlicher Anwendungsstatus; generierte Vorschaubilder und Vorschauen; generierte kodierte Videos; sowie Modell-, Protokoll- oder temporäre Laufzeitdaten. Erfassen Sie für jede Klasse den aktuellen Pfad, die Größe, die Wachstumsrate, die Backup-Richtlinie, die Wiederherstellungskosten und den Dienst, der dort schreibt.

Ein Nutzerbericht über das Wachstum generierter Vorschaubilder und Videos zeigt, warum Vorschaubilder und kodierte Videos getrennt gemessen werden müssen. Die einzelnen Verhältnisse sind nicht allgemeingültig, da Medienmix und Verarbeitungseinstellungen die erzeugte Datenmenge beeinflussen.

Bezeichnen Sie ein Verzeichnis nicht allein deshalb als „Cache“, weil sein Löschen Speicherplatz freigibt. Wenn sein Verlust tagelange Neuerzeugung verursacht, die aktive Wiedergabe beeinträchtigt oder Status entfernt, den Ihr Wiederherstellungsplan aufbewahren soll, verdient es eine ausdrücklich dauerhafte Rolle, selbst wenn die Anwendung es technisch neu erstellen kann.

Platzieren Sie häufig geänderte generierte Daten passend zu Latenz und Haltbarkeit

Vorschaubilder und Vorschauen dienen dem interaktiven Browsen und umfassen häufig viele kleine Lesevorgänge, während kodierte Videos deutlich mehr sequenziellen Speicherplatz beanspruchen können. Eine schnelle SSD kann Aktivitäten mit vielen Ableitungen verbessern, aber nur dann, wenn das Verschieben dieser Rolle die gemessene Wartezeit beseitigt, statt ein weiteres kleines Volume zu schaffen, das unerwartet voll läuft.

Die Erklärung von ZimaSpace zum Wachstum des Vorschaubildspeichers vermittelt eine übertragbare Speichererkenntnis: Der aktive App-Speicher kann sich füllen, selbst wenn die Originale an einem anderen Ort liegen. Die Immich-spezifischen Pfade unterscheiden sich, aber die Notwendigkeit, die tatsächlich beschreibbare Rolle zu überwachen, bleibt gleich.

Wenn umfangreiche Mediendaten auf HDD- oder NAS-Speicher verbleiben, während die Ableitungen auf eine SSD verschoben werden, überwachen Sie die Mindestwerte für den freien Speicherplatz und prüfen Sie nach jedem Neustart alle Einbindungen. Eine schnelle Ableitungsebene ist nur dann sinnvoll, wenn sie für das normale Wachstum groß genug ist und ihr Ausfall nicht mit dem Verlust der maßgeblichen Originale verwechselt werden kann.

Persistieren Sie den Modell-Cache bewusst, behandeln Sie ihn aber als wiederherstellbar

Modelle für maschinelles Lernen werden für wiederholte Inferenz heruntergeladen oder vorbereitet und können beträchtlichen Speicherplatz beanspruchen. Durch die Persistierung des Modell-Caches lassen sich unnötige Downloads und Startvorgänge vermeiden, besonders bei langsameren Verbindungen. Er sollte jedoch nicht mit der Datenbank oder den Originalen der Familie in der Wiederherstellungshierarchie verwechselt werden.

Eine Community-Diskussion über die Immich-Speicherarchitektur zeigt, warum Betreiber schnelle, cacheähnliche Daten vom umfangreichen Fotospeicher trennen. Verwenden Sie solche Layouts nur als Beispiele und prüfen Sie die aktuellen Pfade und Einbindungen in Ihrer eigenen Compose-Definition, bevor Sie etwas verschieben.

Geht der Modell-Cache verloren, besteht die akzeptable Wiederherstellung normalerweise darin, ihn neu zu erstellen oder erneut herunterzuladen, sofern der Dienst die erforderliche Quelle erreichen kann und ausreichend Speicherplatz vorhanden ist. Dokumentieren Sie dieses Verhalten, damit ein Backup-Tool nicht versehentlich knappen Offsite-Speicher für den Schutz eines großen, wiederherstellbaren Caches verwendet.

-15% OFF

ZimaBoard 2 – Mini-Heimserver für Ihre große Idee

Single board computer zimaboard2

Begrenzen Sie beschreibbare Ebenen, Protokolle und temporären Speicher

Beschreibbare Container-Ebenen sollten nicht zu einem undokumentierten Speicherort für dauerhafte Ableitungen, temporäre Transkodierungen oder große Protokolle werden. Prüfen Sie die Docker-Speichernutzung und die Container-Einbindungen, damit jeder große, wachsende Pfad entweder bewusst persistiert oder absichtlich entbehrlich ist. Ein unerklärlicher Anstieg in einer beschreibbaren Ebene ist zunächst ein Konfigurationssymptom und kein Bereinigungsziel.

Der Docker-HQ-Workflow von 2026 für eine sichere Bereinigung des Docker-Speichers betont die Prüfung vor dem Pruning und den Schutz von Volumes, die Datenbanken enthalten können. Wenden Sie diese Vorsicht auch hier an: Führen Sie auf einem produktiven Immich-Host niemals pauschale Bereinigungsbefehle aus, bevor die Zuordnung jedes Volumes und jeder Ebene bekannt ist.

Richten Sie eine Protokollrotation ein, legen Sie temporäre Pfade auf Speicher mit ausreichender kurzfristiger Reserve und überwachen Sie neben der Byte-Nutzung auch die Anzahl der Inodes, wenn viele kleine Dateien erstellt werden. Wenn ein temporärer Pfad voll läuft, besteht die richtige Lösung darin, diese Rolle zu begrenzen oder zu verschieben, nicht darin, unbekannte Verzeichnisse zu löschen, bis die Anwendung zufällig wieder startet.

Validieren Sie Speicheränderungen mit Neustart-, Wiederaufbau- und Freispeichertests

Öffnen Sie nach der Änderung von Pfaden alte und aktuelle Dateien, durchsuchen Sie mehrere Alben, spielen Sie ein Video ab, führen Sie einen Thumbnail- oder Machine-Learning-Job aus und laden Sie eine kontrollierte neue Datei hoch. Bestätigen Sie, dass die Schreibvorgänge auf den vorgesehenen Geräten landen und die Datenbank weiterhin auf lesbare Medien verweist.

Starten Sie zunächst die Container und anschließend den Host neu. Eine funktionierende Konfiguration bindet jede Rolle automatisch erneut ein, behält die erwarteten Ableitungen und den Modell-Cache bei, hält temporäre Daten entbehrlich und meldet auf jeder aktiven Speicherebene ausreichend freien Speicherplatz. Beobachten Sie den Speicher während eines normalen Arbeitszeitraums, um zu bestätigen, dass das Wachstum wie geplant auftritt.

Machen Sie eine Pfadänderung rückgängig, wenn Immich doppelte Verzeichnisse erstellt, fehlende Dateien meldet oder wegen einer fehlgeschlagenen Einbindung unbemerkt in die Container-Ebene schreibt. Stellen Sie bei der Eskalation Einbindungsübersichten, Pfadgrößen, Eigentümer, freien Dateisystemspeicher, die Festplattennutzung der Container und den genauen Job bereit, der zuerst an den falschen Ort geschrieben hat.