diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md
index 333a36e0..159beb7d 100644
--- a/docs/DEPLOYMENT.md
+++ b/docs/DEPLOYMENT.md
@@ -356,6 +356,11 @@ docker compose \
   up -d --wait --remove-orphans
 ```
 
+> **Note:** `cp -r` does not remove deleted files. If a config file is removed from the repo, its stale copy persists at `/opt/familienarchiv/infra/observability/` until manually deleted:
+> ```bash
+> rm /opt/familienarchiv/infra/observability/<path-to-removed-file>
+> ```
+
 Current services:
 
 | Service | Image | Purpose |