From 07716bbff7b79bd2a2307120ff423be0a494f217 Mon Sep 17 00:00:00 2001
From: aviv926 <51673860+aviv926@users.noreply.github.com>
Date: Mon, 15 Apr 2024 15:33:04 +0300
Subject: [PATCH] docs: files custom locations (#8627)

* Files Custom Locations

* minimize

* Easier maintenance

* simplify information

* default .env

---------

Co-authored-by: Alex <alex.tran1502@gmail.com>
---
 docs/docs/guides/custom-locations.md | 50 ++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/docs/guides/custom-locations.md

diff --git a/docs/docs/guides/custom-locations.md b/docs/docs/guides/custom-locations.md
new file mode 100644
index 0000000000..5898120f26
--- /dev/null
+++ b/docs/docs/guides/custom-locations.md
@@ -0,0 +1,50 @@
+# Files Custom Locations
+
+This guide explains storing generated and raw files with docker's volume mount in different locations.
+
+:::note Backup
+It is important to remember to update the backup settings after following the guide to back up the new backup paths if using automatic backup tools.
+:::
+
+In our `.env` file, we will define variables that will help us in the future when we want to move to a more advanced server in the future
+
+```diff title=".env"
+# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables
+
+# Custom location where your uploaded, thumbnails, and transcoded video files are stored
+- {UPLOAD_LOCATION}=./library
++ {UPLOAD_LOCATION}=/custom/location/on/your/system/
++ {THUMB_LOCATION}=/custom/location/on/your/system/
++ {ENCODED_VIDEO_LOCATION}=/custom/location/on/your/system/
+...
+```
+
+After defining the locations for these files, we will edit the `docker-compose.yml` file accordingly and add the new variables to the `immich-server` and `immich-microservices` containers.
+
+```diff title="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
+      - /etc/localtime:/etc/localtime:ro
+
+...
+
+  immich-microservices:
+      volumes:
+      - ${UPLOAD_LOCATION}:/usr/src/app/upload
++     - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
++     - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+      - /etc/localtime:/etc/localtime:ro
+```
+
+Restart Immich to register the changes.
+
+```
+docker compose down
+docker compose up -d
+```
+
+Thanks to [Jrasm91](https://github.com/immich-app/immich/discussions/2110#discussioncomment-5477767) for writing the guide.