From 067a1bfe7b97f7d61d50e451e6a9344e1b5c0a58 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 30 May 2026 06:22:39 +0000
Subject: [PATCH] docs(immich): add instructions for using local disk as data
 storage

Adds clear step-by-step instructions in the Mounting Drives section
of all Immich addon READMEs explaining how to use a mounted local
disk for Immich storage by combining localdisks and data_location.
---
 immich/README.md          | 14 ++++++++++++++
 immich_cuda/README.md     | 14 ++++++++++++++
 immich_noml/README.md     | 14 ++++++++++++++
 immich_openvino/README.md | 14 ++++++++++++++
 4 files changed, 56 insertions(+)

diff --git a/immich/README.md b/immich/README.md
index 836cd3d270..8095715529 100644
--- a/immich/README.md
+++ b/immich/README.md
@@ -87,6 +87,20 @@ This addon supports mounting both local drives and remote SMB shares:
 - **Local drives**: See [Mounting Local Drives in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-Local-Drives-in-Addons)
 - **Remote shares**: See [Mounting Remote Shares in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-remote-shares-in-Addons)
 
+#### Using a Local Disk for Immich Storage
+
+To save Immich data to a mounted local disk:
+
+1. Set the `localdisks` option to your drive name (e.g., `sda1`). The drive will be mounted at `/mnt/sda1`.
+2. Set the `data_location` option to a path on the mounted drive, for example `/mnt/sda1/immich`.
+
+Example configuration:
+
+```yaml
+localdisks: "sda1"
+data_location: "/mnt/sda1/immich"
+```
+
 ### Custom Scripts and Environment Variables
 
 This addon supports custom scripts and environment variables through the `addon_config` mapping:
diff --git a/immich_cuda/README.md b/immich_cuda/README.md
index 9b966cffb7..1edc529470 100644
--- a/immich_cuda/README.md
+++ b/immich_cuda/README.md
@@ -97,6 +97,20 @@ This addon supports mounting both local drives and remote SMB shares:
 - **Local drives**: See [Mounting Local Drives in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-Local-Drives-in-Addons)
 - **Remote shares**: See [Mounting Remote Shares in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-remote-shares-in-Addons)
 
+#### Using a Local Disk for Immich Storage
+
+To save Immich data to a mounted local disk:
+
+1. Set the `localdisks` option to your drive name (e.g., `sda1`). The drive will be mounted at `/mnt/sda1`.
+2. Set the `data_location` option to a path on the mounted drive, for example `/mnt/sda1/immich`.
+
+Example configuration:
+
+```yaml
+localdisks: "sda1"
+data_location: "/mnt/sda1/immich"
+```
+
 ### Custom Scripts and Environment Variables
 
 This addon supports custom scripts and environment variables through the `addon_config` mapping:
diff --git a/immich_noml/README.md b/immich_noml/README.md
index 342e541965..90947f6d13 100644
--- a/immich_noml/README.md
+++ b/immich_noml/README.md
@@ -101,6 +101,20 @@ This addon supports mounting both local drives and remote SMB shares:
 - **Local drives**: See [Mounting Local Drives in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-Local-Drives-in-Addons)
 - **Remote shares**: See [Mounting Remote Shares in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-remote-shares-in-Addons)
 
+#### Using a Local Disk for Immich Storage
+
+To save Immich data to a mounted local disk:
+
+1. Set the `localdisks` option to your drive name (e.g., `sda1`). The drive will be mounted at `/mnt/sda1`.
+2. Set the `data_location` option to a path on the mounted drive, for example `/mnt/sda1/immich`.
+
+Example configuration:
+
+```yaml
+localdisks: "sda1"
+data_location: "/mnt/sda1/immich"
+```
+
 ### Custom Scripts and Environment Variables
 
 This addon supports custom scripts and environment variables through the `addon_config` mapping:
diff --git a/immich_openvino/README.md b/immich_openvino/README.md
index e2ef0229c7..a6842a447f 100644
--- a/immich_openvino/README.md
+++ b/immich_openvino/README.md
@@ -98,6 +98,20 @@ This addon supports mounting both local drives and remote SMB shares:
 - **Local drives**: See [Mounting Local Drives in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-Local-Drives-in-Addons)
 - **Remote shares**: See [Mounting Remote Shares in Addons](https://github.com/alexbelgium/hassio-addons/wiki/Mounting-remote-shares-in-Addons)
 
+#### Using a Local Disk for Immich Storage
+
+To save Immich data to a mounted local disk:
+
+1. Set the `localdisks` option to your drive name (e.g., `sda1`). The drive will be mounted at `/mnt/sda1`.
+2. Set the `data_location` option to a path on the mounted drive, for example `/mnt/sda1/immich`.
+
+Example configuration:
+
+```yaml
+localdisks: "sda1"
+data_location: "/mnt/sda1/immich"
+```
+
 ### Custom Scripts and Environment Variables
 
 This addon supports custom scripts and environment variables through the `addon_config` mapping: