[GH-ISSUE #13] Document traefik setup preconditions #11

Closed
opened 2026-05-06 12:22:39 +02:00 by BreizhHardware · 7 comments

Originally created by @arminus on GitHub (Apr 7, 2026).
Original GitHub issue: https://github.com/chr0nzz/traefik-manager/issues/13

Originally assigned to: @chr0nzz on GitHub.

I stumbled across your project on reddit, thinking that maybe I could give traefik a go with this after all (I'm using https://github.com/lucaslorentz/caddy-docker-proxy since years since traefik was way to complicated back when I looked at it ~ 5 years ago).

So envision a dummy user who doesn't have traefik installed already - what's the barebones traefik setup you need for traefik-manager to begin its supposed magic? I'm already lost when you mount /path/to/traefik/dynamic.yml:/app/config/dynamic.yml - I'm sure I can figure this out with enough time and research, but as I understand this project's value proposition, I actually should not have to dive into the traefik docs in order to manage it?

Just some honest first impression here, no criticism and maybe I don't understood the value proposition...

Originally created by @arminus on GitHub (Apr 7, 2026). Original GitHub issue: https://github.com/chr0nzz/traefik-manager/issues/13 Originally assigned to: @chr0nzz on GitHub. I stumbled across your project on reddit, thinking that maybe I could give traefik a go with this after all (I'm using https://github.com/lucaslorentz/caddy-docker-proxy since years since traefik was way to complicated back when I looked at it ~ 5 years ago). So envision a dummy user who doesn't have traefik installed already - what's the barebones traefik setup you need for traefik-manager to begin its supposed magic? I'm already lost when you mount /path/to/traefik/dynamic.yml:/app/config/dynamic.yml - I'm sure I can figure this out with enough time and research, but as I understand this project's value proposition, I actually should not have to dive into the traefik docs in order to manage it? Just some honest first impression here, no criticism and maybe I don't understood the value proposition...
Author
Owner

@chr0nzz commented on GitHub (Apr 7, 2026):

if you wanna test the installer script, run this

curl -fsSL https://raw.githubusercontent.com/chr0nzz/traefik-stack/main/setup.sh | bash

repo page https://github.com/chr0nzz/traefik-stack

<!-- gh-comment-id:4200909271 --> @chr0nzz commented on GitHub (Apr 7, 2026): if you wanna test the installer script, run this `curl -fsSL https://raw.githubusercontent.com/chr0nzz/traefik-stack/main/setup.sh | bash` repo page https://github.com/chr0nzz/traefik-stack
Author
Owner

@arminus commented on GitHub (Apr 7, 2026):

Great, will check it out tomorrow!

<!-- gh-comment-id:4201429533 --> @arminus commented on GitHub (Apr 7, 2026): Great, will check it out tomorrow!
Author
Owner

@chr0nzz commented on GitHub (Apr 7, 2026):

I've tested this on a few setups. But please report back if you come across any issues. Thanks.

<!-- gh-comment-id:4201636853 --> @chr0nzz commented on GitHub (Apr 7, 2026): I've tested this on a few setups. But please report back if you come across any issues. Thanks.
Author
Owner

@arminus commented on GitHub (Apr 8, 2026):

Ok, I gave it a spin, got stuck though. I have set it up to use http only for now.

I have 2 containers:

CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS                    PORTS                                                                              NAMES
9350c2c59e6a   ghcr.io/chr0nzz/traefik-manager:latest   "gunicorn --bind 0.0…"   36 minutes ago   Up 36 minutes (healthy)   5000/tcp                                                                           traefik-manager
b0efce7d7e30   traefik:latest                           "/entrypoint.sh trae…"   36 minutes ago   Up 36 minutes             0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp   traefik

with these docker IPs:

❯ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' 9350c2c59e6a
172.19.0.3
❯ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' b0efce7d7e30
172.19.0.2

on a host 192.168.0.231

curl http://manager.myinternaldomain.com
Bad Gateway

and in the traefik log

192.168.0.231 - - [08/Apr/2026:08:20:07 +0000] "GET / HTTP/1.1" 502 11 "-" "-" 7 "traefik-manager@docker" "http://172.19.0.3:3000" 0ms

manager.myinternaldomain.com DNS resolves to 192.168.0.231

<!-- gh-comment-id:4204845789 --> @arminus commented on GitHub (Apr 8, 2026): Ok, I gave it a spin, got stuck though. I have set it up to use http only for now. I have 2 containers: ``` CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 9350c2c59e6a ghcr.io/chr0nzz/traefik-manager:latest "gunicorn --bind 0.0…" 36 minutes ago Up 36 minutes (healthy) 5000/tcp traefik-manager b0efce7d7e30 traefik:latest "/entrypoint.sh trae…" 36 minutes ago Up 36 minutes 0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp traefik ``` with these docker IPs: ``` ❯ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' 9350c2c59e6a 172.19.0.3 ❯ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' b0efce7d7e30 172.19.0.2 ``` on a host 192.168.0.231 ``` curl http://manager.myinternaldomain.com Bad Gateway ``` and in the traefik log ``` 192.168.0.231 - - [08/Apr/2026:08:20:07 +0000] "GET / HTTP/1.1" 502 11 "-" "-" 7 "traefik-manager@docker" "http://172.19.0.3:3000" 0ms ``` manager.myinternaldomain.com DNS resolves to 192.168.0.231
Author
Owner

@chr0nzz commented on GitHub (Apr 8, 2026):

Thanks for testing this and reporting back - you found a real bug in the script.

The 502 was caused by the setup script telling Traefik to forward traffic to port 3000 on the manager container, but the container actually listens on port 5000. Traefik could reach the container but nothing was answering on that port, hence the bad gateway.

Also fixed a second issue in the same script where the CONFIG_DIR environment variable was being set to Traefik's internal config path instead of the manager's mounted path - this would have caused problems for anyone who chose the directory config layout.

Both are fixed in the latest version of the script. You can re-run it:

curl -fsSL https://raw.githubusercontent.com/chr0nzz/traefik-stack/main/setup.sh | bash
If you already have the stack running, just update the label in your docker-compose.yml at ~/traefik-stack/docker-compose.yml:

  • "traefik.http.services.traefik-manager.loadbalancer.server.port=5000"
    Then run docker compose up -d traefik-manager to apply it.
<!-- gh-comment-id:4206843532 --> @chr0nzz commented on GitHub (Apr 8, 2026): Thanks for testing this and reporting back - you found a real bug in the script. The 502 was caused by the setup script telling Traefik to forward traffic to port 3000 on the manager container, but the container actually listens on port 5000. Traefik could reach the container but nothing was answering on that port, hence the bad gateway. Also fixed a second issue in the same script where the CONFIG_DIR environment variable was being set to Traefik's internal config path instead of the manager's mounted path - this would have caused problems for anyone who chose the directory config layout. Both are fixed in the latest version of the script. You can re-run it: curl -fsSL https://raw.githubusercontent.com/chr0nzz/traefik-stack/main/setup.sh | bash If you already have the stack running, just update the label in your docker-compose.yml at ~/traefik-stack/docker-compose.yml: - "traefik.http.services.traefik-manager.loadbalancer.server.port=5000" Then run `docker compose up -d traefik-manager `to apply it.
Author
Owner

@arminus commented on GitHub (Apr 8, 2026):

Thanks, that works now and is a great help to start this from scratch.

<!-- gh-comment-id:4206995698 --> @arminus commented on GitHub (Apr 8, 2026): Thanks, that works now and is a great help to start this from scratch.
Author
Owner

@chr0nzz commented on GitHub (Apr 8, 2026):

Right on 👍

<!-- gh-comment-id:4207004183 --> @chr0nzz commented on GitHub (Apr 8, 2026): Right on 👍
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/traefik-manager#11
No description provided.