diff --git a/apps/docs/content/docs/core/installation.mdx b/apps/docs/content/docs/core/installation.mdx
index 1a60ce0..71ffcb8 100644
--- a/apps/docs/content/docs/core/installation.mdx
+++ b/apps/docs/content/docs/core/installation.mdx
@@ -112,13 +112,16 @@ curl -sSL https://dokploy.com/install.sh | sh
 
 #### Manual Advertise Address
 
-If the script cannot detect your server's IP automatically, specify it manually:
+If the script cannot detect your server's IP automatically, or you want the Swarm to use a specific interface (e.g. a VPN/WireGuard IP), specify it manually:
 
 ```bash
-export ADVERTISE_ADDR=192.168.1.100
-curl -sSL https://dokploy.com/install.sh | sh
+curl -sSL https://dokploy.com/install.sh | sudo ADVERTISE_ADDR=192.168.1.100 sh
 ```
 
+<Callout type='warn'>
+  If you run the installer with `sudo`, don't rely on `export ADVERTISE_ADDR=...` from your user shell — `sudo` resets the environment, so the variable never reaches the script and it falls back to auto-detection. Pass the variable inline as shown above, or use `sudo -E sh` to preserve your environment. The same applies to `DOKPLOY_VERSION` and `DOCKER_SWARM_INIT_ARGS`.
+</Callout>
+
 ### Proxmox LXC Support
 
 <Callout type='info'>
diff --git a/apps/docs/content/docs/core/manual-installation.mdx b/apps/docs/content/docs/core/manual-installation.mdx
index bdb96f1..20f12b0 100644
--- a/apps/docs/content/docs/core/manual-installation.mdx
+++ b/apps/docs/content/docs/core/manual-installation.mdx
@@ -373,10 +373,11 @@ curl -sSL https://dokploy.com/install.sh | sh
 
 **Manual Advertise Address:**
 ```bash
-export ADVERTISE_ADDR=192.168.1.100
-curl -sSL https://dokploy.com/install.sh | sh
+curl -sSL https://dokploy.com/install.sh | sudo ADVERTISE_ADDR=192.168.1.100 sh
 ```
 
+Note: if you run the installer with `sudo`, pass the variable inline as shown above. Using `export` beforehand won't work because `sudo` resets the environment before executing the script.
+
 ## Updating Traefik Manually
 
 Dokploy does not update the Traefik container automatically when you upgrade. This is intentional to avoid unexpected downtime for your services. If you need a newer Traefik version (for example, due to a breaking change or security fix), you can update it manually.
diff --git a/apps/docs/content/docs/core/troubleshooting.mdx b/apps/docs/content/docs/core/troubleshooting.mdx
index b250dbc..e12b4cd 100644
--- a/apps/docs/content/docs/core/troubleshooting.mdx
+++ b/apps/docs/content/docs/core/troubleshooting.mdx
@@ -290,9 +290,11 @@ To fix this, you need to assign a the public IP address to the Docker Swarm, ide
 will need to use a public IP address.
 
 ```bash
-curl -sSL https://dokploy.com/install.sh | ADVERTISE_ADDR=your-ip sh
+curl -sSL https://dokploy.com/install.sh | sudo ADVERTISE_ADDR=your-ip sh
 ```
 
+Note: pass `ADVERTISE_ADDR` inline as shown above — if you `export` it in your shell and then run the script with `sudo`, the variable won't reach the script because `sudo` resets the environment.
+
 
 ## My Dokploy UI Instance is Not Accessible