diff --git a/docs/configuration.md b/docs/configuration.md
index 3c0bbcff1..16207917c 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -1072,6 +1072,8 @@ Disable live reload (and file watching) if the directory is large or you hit `EM
 }
 ```
 
+Changes to `canvasHost.*` require a gateway restart (config reload will restart).
+
 Disable with:
 - config: `canvasHost: { enabled: false }`
 - env: `CLAWDBOT_SKIP_CANVAS_HOST=1`