Dateien Benutzerdefinierte Speicherorte

Dieser Leitfaden erklärt, wie generierte und Rohdateien mit docker's Volume-Mount an verschiedenen Speicherorten gespeichert werden können.

:::vorsicht Backup Es ist wichtig, daran zu denken, die Backup-Einstellungen nach Befolgung dieses Leitfadens zu aktualisieren, um die neuen Backup-Pfade zu sichern, falls automatische Backup-Tools verwendet werden, insbesondere profile/. :::

In unserer .env-Datei definieren wir die Speicherorte, die wir verwenden möchten. Beachten Sie, dass Sie nicht alle definieren müssen: UPLOAD_LOCATION ist der Basisordner, in dem Dateien standardmäßig gespeichert werden, wobei die anderen Pfade als Overrides dienen.

.env

# Sie können die Dokumentation zu allen unterstützten Umgebungsvariablen [hier](/docs/install/environment-variables) finden

# Benutzerdefinierter Speicherort, an dem Ihre hochgeladenen Dateien, Thumbnails und transcodierten Video-Dateien gespeichert werden
- UPLOAD_LOCATION=./library
+ UPLOAD_LOCATION=/custom/path/immich/immich_files
+ THUMB_LOCATION=/custom/path/immich/thumbs
+ ENCODED_VIDEO_LOCATION=/custom/path/immich/encoded-video
+ PROFILE_LOCATION=/custom/path/immich/profile
+ BACKUP_LOCATION=/custom/path/immich/backups
...

Nachdem die Speicherorte dieser Dateien definiert wurden, bearbeiten wir die docker-compose.yml-Datei entsprechend und fügen die neuen Variablen in den immich-server-Container ein. Diese Pfade sind dort, wo das Mounten im Container erfolgt, daher sollten Sie diese nicht ändern.

docker-compose.yml

services:
  immich-server:
      volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
+     - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
+     - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+     - ${PROFILE_LOCATION}:/usr/src/app/upload/profile
+     - ${BACKUP_LOCATION}:/usr/src/app/upload/backups
      - /etc/localtime:/etc/localtime:ro

Nachdem Sie diese Änderung vorgenommen haben, müssen Sie die Dateien in die neuen Ordner verschieben, damit Immich alles finden kann, was es benötigt. Falls Sie noch nichts Wichtiges hochgeladen haben, können Sie Immich vollständig zurücksetzen, indem Sie den Datenbankordner löschen. Starten Sie Immich danach neu, um die Änderungen zu registrieren:

docker compose up -d

Aufgrund der zugrunde liegenden Eigenschaften von Docker Bind-Mounts wird nicht empfohlen, die Ordner upload/ und library/ als separate Bind-Mounts zu verwenden, wenn sie sich auf demselben Gerät befinden. Aus diesem Grund mounten wir die HDD oder den Netzwerkspeicher (NAS) auf /usr/src/app/upload und mounten dann die Ordner, auf die wir zugreifen möchten, unter diesem Ordner.

Der Ordner thumbs/ enthält sowohl die kleinen Thumbnails, die in der Zeitleiste angezeigt werden, als auch die größeren Vorschauen, die beim Anklicken eines Bildes gezeigt werden. Diese dürfen nicht getrennt werden.

Die Speicherstatistiken des Immich-Servers verfolgen den verfügbaren Speicherplatz unter UPLOAD_LOCATION, sodass der Administrator eine Art Überwachung einrichten muss, um sicherzustellen, dass der Speicherplatz nicht knapp wird. Der Ordner profile/ ist deutlich kleiner, normalerweise weniger als 1 MB.