Dokploy/website
1
0
Fork 0
mirror of https://github.com/Dokploy/website.git synced 2026-07-12 17:35:24 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: update installation and troubleshooting guides for ADVERTISE_ADDR usage

Browse Source 
- Clarified instructions for setting the ADVERTISE_ADDR variable when running the installation script with sudo, emphasizing the need to pass the variable inline.
- Added warnings in the installation and troubleshooting sections to prevent confusion regarding environment variable handling with sudo.
This commit is contained in:
Mauricio Siu
2026-07-07 03:39:11 -06:00
parent c03c59c391
commit c44d9b2d8b
3 changed files with 12 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
apps/docs/content/docs/core/installation.mdx
View File

@@ -112,13 +112,16 @@ curl -sSL https://dokploy.com/install.sh | sh
#### Manual Advertise Address #### 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 ```bash
export ADVERTISE_ADDR=192.168.1.100 curl -sSL https://dokploy.com/install.sh | sudo ADVERTISE_ADDR=192.168.1.100 sh
curl -sSL https://dokploy.com/install.sh | 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 ### Proxmox LXC Support
<Callout type='info'> <Callout type='info'>

5
apps/docs/content/docs/core/manual-installation.mdx
View File

@@ -373,10 +373,11 @@ curl -sSL https://dokploy.com/install.sh | sh
**Manual Advertise Address:** **Manual Advertise Address:**
```bash ```bash
export ADVERTISE_ADDR=192.168.1.100 curl -sSL https://dokploy.com/install.sh | sudo ADVERTISE_ADDR=192.168.1.100 sh
curl -sSL https://dokploy.com/install.sh | 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 ## 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. 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.

4
apps/docs/content/docs/core/troubleshooting.mdx
View File

@@ -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. will need to use a public IP address.
```bash ```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 ## My Dokploy UI Instance is Not Accessible