diff --git a/PRODUCCION.md b/PRODUCCION.md
index 7685fc2..efedfc9 100644
--- a/PRODUCCION.md
+++ b/PRODUCCION.md
@@ -31,7 +31,10 @@
 ## Servicio systemd
 
 - Servicio: `pflores-web.service`
-- Puerto interno: `127.0.0.1:8081`
+- Puerto: `0.0.0.0:8081`
+
+> ⚠ **El servicio DEBE escuchar en `0.0.0.0:8081`**, no en `127.0.0.1:8081`.
+> NPM viene de una IP externa y no puede alcanzar el loopback. Si queda en `127.0.0.1` el resultado es **502 Bad Gateway**.
 
 ```bash
 sudo systemctl status pflores-web
diff --git a/PROMPT_IA.md b/PROMPT_IA.md
index 0950736..1db723a 100644
--- a/PROMPT_IA.md
+++ b/PROMPT_IA.md
@@ -788,9 +788,11 @@ echo "1.0.1" > VERSION
 - `deploy` tiene sudo NOPASSWD
 - Ruta app: `/opt/apps/pflores.linkedcorp.net`
 - Servicio systemd: `pflores-web.service`
-- Puerto interno: `127.0.0.1:8081`
+- Puerto: `0.0.0.0:8081`
 - NPM proxy: `pflores.linkedcorp.net` → `192.168.222.3:8081`
 
+> ⚠ El servicio **debe** escuchar en `0.0.0.0:8081`, no en `127.0.0.1`. NPM llega desde fuera del loopback — si queda en `127.0.0.1` el resultado es **502 Bad Gateway**.
+
 Credenciales SSH: ver `LOCAL_DEPLOY_CONTEXT.md`
 
 ### Estructura en producción