Dokploy/website
1
0
Fork 0
mirror of https://github.com/Dokploy/website.git synced 2026-07-07 23:15:30 +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
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'>

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:**
```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.

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.
```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