Skip to content

Commit 0809cc7

Browse files
committed
docs: add manual update instructions for Traefik container
Included a new section detailing the steps to manually update the Traefik container in Dokploy, emphasizing the importance of checking for breaking changes in Traefik versions before upgrading. Close #127
1 parent ec7ed20 commit 0809cc7

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

apps/docs/content/docs/core/manual-installation.mdx

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -372,3 +372,34 @@ curl -sSL https://dokploy.com/install.sh | sh
372372
export ADVERTISE_ADDR=192.168.1.100
373373
curl -sSL https://dokploy.com/install.sh | sh
374374
```
375+
376+
## Updating Traefik Manually
377+
378+
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.
379+
380+
1. Remove the existing Traefik container.
381+
2. Create a new container with the desired Traefik image version and the same configuration.
382+
3. Connect the new container to the Dokploy network.
383+
384+
Example (replace `v3.6.7` with the version you want):
385+
386+
```bash
387+
docker rm -f dokploy-traefik
388+
389+
docker run -d \
390+
--name dokploy-traefik \
391+
--restart always \
392+
-v /etc/dokploy/traefik/traefik.yml:/etc/traefik/traefik.yml \
393+
-v /etc/dokploy/traefik/dynamic:/etc/dokploy/traefik/dynamic \
394+
-v /var/run/docker.sock:/var/run/docker.sock:ro \
395+
-p 80:80/tcp \
396+
-p 443:443/tcp \
397+
-p 443:443/udp \
398+
traefik:v3.6.7
399+
400+
docker network connect dokploy-network dokploy-traefik
401+
```
402+
403+
<Callout type='warn'>
404+
**Breaking changes:** Some Traefik versions introduce breaking changes that may not be compatible with the configuration and structure Dokploy uses. Before upgrading, check the [Traefik release notes](https://github.com/traefik/traefik/releases) and [Dokploy releases](https://github.com/Dokploy/dokploy/releases) for any announced breaking changes. Using an incompatible version can cause routing issues (e.g. 404s for applications using domains).
405+
</Callout>

0 commit comments

Comments
 (0)