.env.sample

@@ -22,4 +22,18 @@ DB_DATA_LOCATION=./postgres
 DB_USERNAME=postgres
 DB_DATABASE_NAME=immich
 
+#### from here on you can edit again
+
 SECRET_DB_PASSWORD_VERSION=v1
+
+
+## Additional Storage:
+
+# COMPOSE_FILE="compose.yml"
+
+# external storage
+# COMPOSE_FILE="$COMPOSE_FILE:compose.storage.yml"
+# STORAGE_DEVICE="//uxxxxx-sub1.your-server.de/uxxxxx-sub1"
+# STORAGE_USERNAME="uuxxxxx-sub1"
+# STORAGE_PASSWORD="<your-password-not-to-be-checked-in-unencrypted-in-a-git-repository-"
+# STORAGE_READONLY=":ro"

README.md

@@ -39,3 +39,10 @@ You can manually create a volume that has more storage for the library. For exam
 	--opt o=addr=uxxxxx.your-server.de,username=uxxxxxxx,password=*****,file_mode=0777,dir_mode=0777 \
 	--name immich_example_com_uploads
 ``` 
+
+## External Library
+
+If you want to use the [external library functionality](https://docs.immich.app/guides/external-library/) of immich via a cifs/smb-share-drive you can use the additional `compose.storage.yml` file.
+Just uncomment and edit the respective .env-files.
+
+The external storage will be mounted to `/mnt/external_storage` (this is your import path in immich).

compose.storage.yml

@@ -0,0 +1,15 @@
+---
+version: "3.8"
+
+services:
+  app:
+    volumes:
+      - external_storage:/mnt/external_storage${STORAGE_READONLY}
+
+volumes:
+  external_storage:
+    driver: local
+    driver_opts:
+      type: cifs
+      device: ${STORAGE_DEVICE}
+      o: "username=${STORAGE_USERNAME},password=${STORAGE_PASSWORD}"