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: