From a7933f7420e15e59d06069f8fecfd6a5d4a0f24d Mon Sep 17 00:00:00 2001
From: Scrum4Me Agent <30029041+madhura68@users.noreply.github.com>
Date: Sun, 3 May 2026 18:23:06 +0200
Subject: [PATCH] docs(ST-mmuwreer): README deploy-procedure force-recreate na
 compose-wijziging
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Voeg subsectie toe in "Updaten" die uitlegt dat docker compose restart
niet voldoende is bij volumes/tmpfs/ports-wijzigingen — force-recreate
is verplicht. Inclusief verify-stap met df -h /var/cache.
---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 0e64016..5f09298 100644
--- a/README.md
+++ b/README.md
@@ -114,6 +114,26 @@ docker compose up -d
 Dezelfde flow voor schema-drift in scrum4me-mcp: pin een nieuwe
 `MCP_GIT_REF` in `.env` of in `docker-compose.yml`, rebuild.
 
+### Wijzigingen in `docker-compose.yml` (volumes, tmpfs, env_file, ports)
+
+> **Let op:** `docker compose restart` herstart alleen het proces in de
+> bestaande container met de **oude** config. Wijzigingen in volumes,
+> tmpfs-mounts, env_file of ports worden daarmee **niet** doorgevoerd.
+
+Gebruik altijd `--force-recreate` als je `docker-compose.yml` is veranderd:
+
+```bash
+docker compose up -d --force-recreate agent
+```
+
+Verifieer daarna dat `/var/cache` op de NAS-overlay staat en **niet** op tmpfs:
+
+```bash
+docker exec scrum4me-agent df -h /var/cache
+# Verwacht: Filesystem op /dev/mapper/cachedev* of een NAS-share
+# Fout:     tmpfs  16M  ... (dan is force-recreate niet uitgevoerd)
+```
+
 ## Health-endpoint
 
 `GET http://<nas>:8080/health` retourneert: