From 77e38abe91512c9626bc0cf4246ddd2080db3816 Mon Sep 17 00:00:00 2001
From: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com>
Date: Mon, 11 Sep 2023 12:16:03 +0200
Subject: [PATCH] chore: update env docs to, indicate that a container restart
 is necessary (#4054)

---
 docs/docs/install/environment-variables.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/docs/install/environment-variables.md b/docs/docs/install/environment-variables.md
index a4c2a95e59c..a006a3b0cc3 100644
--- a/docs/docs/install/environment-variables.md
+++ b/docs/docs/install/environment-variables.md
@@ -4,6 +4,17 @@ sidebar_position: 90
 
 # Environment Variables
 
+:::caution
+
+To change environment variables, you must recreate the Immich containers.
+Just restarting the containers does not replace the environment within the container!
+
+In order to recreate the container using docker compose, run `docker compose up -d`.
+In most cases docker will recognize that the `.env` file has changed and recreate the affected containers.
+If this should not work, try running `docker compose up -d --force-recreate`.
+
+:::
+
 ## Docker Compose
 
 | Variable          | Description           |  Default  | Services                                                       |