Traefik reload fails silently with "Error: Resource type not found" - Traefik never gets created
About the bug
Clicking "Reload" in the Web Server / Traefik panel does nothing - no Traefik container or service is ever created, and the Dokploy server logs show:
reloadTraefik background: Error: Resource type not found
This happens repeatedly on every Reload click, with no other visible error in the UI. The dashboard gives no indication that the reload failed.
To Reproduce
- Fresh Dokploy install on a Docker Swarm single-node VPS
- Traefik container/service is absent (e.g. after manually removing it, or after it never started on a fresh install) in my case I installed few open-source project and my VPS restarted for maintainace then the Traefik container was missing
- Go to Web Server panel → click Reload
- Check
docker ps -a | grep traefikanddocker service ls | grep traefik→ nothing is created - Check Dokploy server logs → see
reloadTraefik background: Error: Resource type not found
Server logs
[wait-for-postgres] Postgres is reachable ✅ Migration complete ✅ initialization complete Server Started on: http://0.0.0.0:3000 Default middlewares already exists Network is already initialized ... Error fetching update data: TypeError: fetch failed [cause]: Error: getaddrinfo EAI_AGAIN hub.docker.com reloadTraefik background: Error: Resource type not found reloadTraefik background: Error: Resource type not found
Current vs. Expected behavior
Current behavior
Clicking "Reload" in the Web Server / Traefik panel does nothing — no Traefik
container or service is ever created. The dashboard gives no indication that
the reload failed. Checking docker ps -a | grep traefik and
docker service ls | grep traefik shows nothing was created.
The Dokploy server logs reveal the actual failure:
reloadTraefik background: Error: Resource type not found
This happens on every Reload click, with no visible error surfaced in the UI. This occurred after Traefik went missing following a VPS restart for maintenance (Traefik was not Swarm-managed/restart-persistent, so it did not come back up on its own, and Reload could not recreate it either).
Expected Behaviour
Reload should detect that no Traefik container/service exists and create a new one from scratch. At minimum, if the reload fails internally, the UI should surface a clear error message instead of failing silently in the background logs only.
Provide environment information
- Dokploy version: v0.30.6
- Deployment mode: Docker Swarm, single node
- OS: Ubuntu 24.04.3 LTS (GNU/Linux 6.8.0-79-generic x86_64)
- Install method: official install scriptWhich area(s) are affected? (Select all that apply)
Traefik, Remote server
Are you deploying the applications where Dokploy is installed or on a remote server?
Same server where Dokploy is installed
Additional context
Suspect this is related to the port-mapping / resource-type read that reloadTraefik performs before reconciling Traefik's config — possibly choking when no existing Traefik container/service is present to compare against, or on a stale/unsupported port-mapping entry.
There's also a separate, likely-unrelated error in the same logs:
Error fetching update data: TypeError: fetch failed ... getaddrinfo EAI_AGAIN hub.docker.com. This looks like Dokploy's background
update-checker failing DNS resolution to hub.docker.com — flagging it here
for completeness, but I don't believe it's connected to the reload bug.
Workaround: Running Traefik manually via docker run (outside of
Dokploy's management) brings the web server back up:
docker run -d --name dokploy-traefik --restart always --network dokploy-network -v /etc/dokploy/traefik/traefik.yml:/etc/traefik/traefik.yml -v /etc/dokploy/traefik/dynamic:/etc/dokploy/traefik/dynamic -v /var/run/docker.sock:/var/run/docker.sock:ro -p 80:80/tcp -p 443:443/tcp -p 443:443/udp traefik:v3.6.1
This resolves the immediate 521 error, but since Traefik is no longer
managed by Dokploy, any new project's network has to be manually connected
with docker network connect <network> dokploy-traefik or it will 404
until that's done.
Will you send a PR to fix it?
Maybe, need help
Source: Dokploy/dokploy