Traefik http proxy with pterodactyl | Pterodactyl® | Page 1

errant cradleBOT Oct 25, 2025, 4:48 PM

#

If you want to install Pterodactyl Panel, please have a look at our documentation: https://pterodactyl.io/panel/getting_started.html

raven gate Oct 25, 2025, 4:57 PM

#

📎 docker-compose.yml

analog stone Oct 25, 2025, 8:27 PM

#

do you perhaps have a vpn that uses the same address space?

also, why the wide /16 address space for 1 service that only potentially uses 1-5 ip addresses internally?

raven gate Oct 25, 2025, 9:04 PM

#

The compose is by no means optimal at this point when I'm trying to make it work first. I mostly hacked it together from multiple guides and I only partially understand what I'm doing. Though from the logs the issue I presume is caused by wings trying to create an interface pterodactyl0, but it fails because it overlaps with a pre-existing network.

ptero-wings | INFO: [Oct 25 18:13:32.301] loading configuration from file config_file=/etc/pterodactyl/config.yml ptero-wings | INFO: [Oct 25 18:13:32.301] configured wings with system timezone timezone=UTC ptero-wings | INFO: [Oct 25 18:13:32.301] configured system user successfully gid=988 uid=988 username=pterodactyl ptero-wings | INFO: [Oct 25 18:13:32.302] fetching list of servers from API ptero-wings | INFO: [Oct 25 18:13:32.410] processing servers returned by the API total_configs=0 ptero-wings | INFO: [Oct 25 18:13:32.410] finished processing server configurations duration=150.97µs ptero-wings | INFO: [Oct 25 18:13:32.412] creating missing pterodactyl0 interface, this could take a few seconds... ptero-wings | FATAL: [Oct 25 18:13:32.413] failed to configure docker environment error=Error response from daemon: invalid pool request: Pool overlaps with other one on this address space ptero-wings | ptero-wings | Stacktrace: ptero-wings | Error response from daemon: invalid pool request: Pool overlaps with other one on this address space

Explicitly declaring the pterodactyl0 network in the compose file or creating it with docker network create doesn't affect it because it still tries to create the network, and again fails. I did try to apply this #docker-help message and it did resolve that error, but then I got a new error.

ptero-wings | FATAL: [Oct 25 19:03:15.077] failed to load server configurations error=manager: failed to retrieve server configurations: Error response from Panel:

errant cradleBOT Oct 25, 2025, 9:04 PM

#

@raven gate; That's a fun one! You already have an existing Docker network that currently conflicts with Pterodactyl.
Change your Wings subnet to a different one by editing the Wings config file at /etc/pterodactyl/config.yml

Example network configuration can be found here: #docker-help message

analog stone Oct 25, 2025, 9:08 PM

#

what does your config.yml looks like?

raven gate Oct 25, 2025, 9:23 PM

#

This is the config.yml I tried to use and caused the overlap problem

debug: false
uuid: dadd02c5-494f-4532-b2a2-d194c38534e8
token_id: SLJLsb9U6VlKOChd
token: bxvLASI95W34UXeoFsymo4ehXPLe96aUmYlQa5hmBnHXqzarWoPifD1AWPddiwBy
api:
  host: 0.0.0.0
  port: 8080
  ssl:
    enabled: false
    cert: /etc/letsencrypt/live/node.home.internal/fullchain.pem
    key: /etc/letsencrypt/live/node.home.internal/privkey.pem
  upload_limit: 100
system:
  data: /var/lib/pterodactyl/volumes
  sftp:
    bind_port: 2022
allowed_mounts: []
remote: 'http://panel.home.internal'

When I applied the advice from #docker-help message and made some tweaks to it, wings generated this full config (attachment).

#

📎 config.yml

analog stone Oct 25, 2025, 9:32 PM

#

not sure about this but for the sake of sanity check, could you add a direct volume bind to config.yml to wings in your docker compose file?

#

I do see - ${DATA_DIR}/wings/config:/etc/pterodactyl under wings
but I'm not sure it can see the yaml file?

I often have images that doesn't properly sync the folder so try doing a direct bind for now and see if it sees it this time

raven gate Oct 25, 2025, 9:39 PM

#

You mean like this?

${DATA_DIR}/wings/config/config.yml:/etc/pterodactyl/config.yml

That didn't seem to change things.

analog stone Oct 25, 2025, 9:43 PM

#

raven gate The compose is by no means optimal at this point when I'm trying to make it work...

does the last error really just end on Error response from Panel: and nothing next to it?

raven gate Oct 25, 2025, 9:46 PM

#

Sorry, hit the message limit. Here it is.

📎 wings.log

analog stone Oct 25, 2025, 10:00 PM

#

saw this on github https://github.com/pterodactyl/panel/issues/3540

I'm guessing you just have to make sure the panel container runs first before the wings?

maybe add a

wings:
  depends_on:
    panel:
      condition: service_healthy

#

either that or the other way around

panel:
  depends_on:
    wings:
      condition: service_healthy

#

you could also add restart: true under that condition

raven gate Oct 25, 2025, 10:11 PM

#

I applied the latter but I get "dependency failed to start: container ptero-panel has no healthcheck configured". Does this imply you need to create a custom healthcheck for the panel because I don't know what I would be checking for.

analog stone Oct 25, 2025, 10:16 PM

#

I read more about depends_on, looks like you don't need the condition at all
just do

depends_on:
  - panel

raven gate Oct 25, 2025, 10:23 PM

#

I tried the depends_on condition with wings and panel separately and it didn't seem to have an effect.

#

I suppose the root cause of my issue could be something really simple like a network configuration on the host or in the compose or a permission issue. But then again it could be something maximally obscure. This is a little aboe my paygrade, I might go back to hosting my minecraft server on docker directly.

analog stone Oct 25, 2025, 10:33 PM

#

could you check traefik if you need whitelisting as well just like this issue https://github.com/pterodactyl/panel/discussions/4802
although this is on cloudflare waf, I'm not familiar enough with nginx nor traefik to know if there needs whitelisting as well

raven gate Oct 25, 2025, 10:44 PM

#

Not sure if that issue is analogous to mine. Traefik doesn't seem to filter by ip by default.

analog stone Oct 25, 2025, 10:55 PM

#

raven gate

what is ${PANEL_DOMAIN} on panel section?

raven gate Oct 25, 2025, 10:56 PM

#

They're defined in my env. file

DATA_DIR=/srv/docker/ptero
WINGS_DOMAIN=node.home.internal
PANEL_DOMAIN=panel.home.internal

analog stone Oct 25, 2025, 11:07 PM

#

hmm so far we've only looked at the wings error logs, what about the panel itself?

raven gate Oct 25, 2025, 11:12 PM

#

Heres the full log for "docker compose up"

📎 compose.log

analog stone Oct 25, 2025, 11:17 PM

#

well

#

looks like it just kept on restarting

#

since the panel was still setting up

#

at the very end there it worked fine

raven gate Oct 25, 2025, 11:21 PM

#

I can't access the panel anymore though via the panel domain. Removing the wings config.yml completely makes it work again. Not sure how its affecting the panel functionality, conflicting network configurations maybe?

analog stone Oct 25, 2025, 11:23 PM

#

raven gate I can't access the panel anymore though via the panel domain. Removing the wings...

you mean the sanity check I requested you to do?
without it, the panel works, but can it find wings?

raven gate Oct 25, 2025, 11:29 PM

#

Without the config.yml wings does this repeatedly on startup.
ptero-wings exited with code 1 (restarting)
ptero-wings | 2025/10/25 23:27:04 cmd/root: error while reading configuration file: read /etc/pterodactyl/config.yml: is a directory
ptero-wings exited with code 1 (restarting)
ptero-wings | 2025/10/25 23:27:06 cmd/root: error while reading configuration file: read /etc/pterodactyl/config.yml: is a directory
ptero-wings exited with code 1 (restarting)
ptero-wings | 2025/10/25 23:27:09 cmd/root: error while reading configuration file: read /etc/pterodactyl/config.yml: is a directory
ptero-wings exited with code 1 (restarting)

But wings wouldnt run anyway without the config file

#

That ouput might be because the docker volume is bound to config.yml directly at the moment

#

(its not)

analog stone Oct 25, 2025, 11:36 PM

#

read /etc/pterodactyl/config.yml: is a directory usually happens when there's supposed to be a file but it doesn't exist and nothing handles the creation of the file so docker itself creates a folder

does your browser output any error if you put the config.yml file back?

#

also, I'm really interested in this but I haven't had even a wink of sleep yet, so I might just crash and not reply for a few hours. hopefully your installation is still there for us to pick back up on this

raven gate Oct 25, 2025, 11:37 PM

#

Wait there actually was a directory called config.yml in the wings/config/ directory, dont know where that came from but I removed it, anyway without the config.yml wings just outputs this repeatedly which is expected behaviour.

ptero-wings     | 
ptero-wings     | Error: Configuration File Not Found
ptero-wings     | 
ptero-wings     | Wings was not able to locate your configuration file, and therefore is not
ptero-wings     | able to complete its boot process. Please ensure you have copied your instance
ptero-wings     | configuration file into the default location below.
ptero-wings     | 
ptero-wings     | Default Location: /etc/pterodactyl/config.yml
ptero-wings     | 
ptero-wings     | This is not a bug with this software. Please do not make a bug report
ptero-wings     | for this issue, it will be closed.
ptero-wings     | 
ptero-wings exited with code 1 (restarting)

errant cradleBOT Oct 25, 2025, 11:37 PM

#

No need to rush @raven gate! It appears that you skipped a step during your Wings installation and didn't create a configuration file as instructed here https://pterodactyl.io/wings/1.0/installing.html#configure

raven gate Oct 25, 2025, 11:39 PM

#

And I can access the panel normally through http://panel.home.internal.

#Traefik http proxy with pterodactyl