diff --git a/docs/hooks-and-api.md b/docs/hooks-and-api.md
index 42a3132..4b4190f 100644
--- a/docs/hooks-and-api.md
+++ b/docs/hooks-and-api.md
@@ -59,8 +59,9 @@ return [
 El Docker debe estar corriendo. Hacer curl al endpoint del hook:
 
 ```bash
-curl http://localhost:8080/hooks/example_hook/
+curl {ACAI_WEB_URL}/hooks/example_hook/
 ```
+(Use the project's actual URL, never localhost:8080)
 
 No usar X-Hooks-Token en desarrollo local.
 
diff --git a/docs/knowledge-index-base.md b/docs/knowledge-index-base.md
index c5d5a9a..94df73f 100644
--- a/docs/knowledge-index-base.md
+++ b/docs/knowledge-index-base.md
@@ -4,9 +4,10 @@ This is an Acai CMS website project. Follow these instructions when working with
 
 ## Environment
 
-- The site runs in Docker, typically at **http://localhost:8080**
-- You can make HTTP requests to test pages, APIs, or form submissions
-- If you need to inspect the live site, use browser tools (Playwright MCP) or HTTP requests to localhost:8080
+- The site runs in Docker. The public URL is the project's domain (e.g. `https://username_domain.forge.acaisuite.com/`)
+- You can make HTTP requests to test pages, APIs, or form submissions using the project's public URL
+- If you need to inspect the live site, use browser tools (Playwright MCP) or HTTP requests to the project URL
+- **NEVER use localhost:8080** — that does not resolve in this environment. Always use the project's actual URL.
 
 ## Project Structure