troubleshooting.md

Troubleshooting

Can't join Game Server/s

This section is to assist with troubleshooting port forwards, firewall rules and DDNS issues.

This guide is assuming you're hosting the server in your home network, not on a cloud host.

Confirm there is not an DDNS issue

You can skip troubleshooting DDNS by trying to connect to your game server via your public IP instead

1. Go to google and search 'what is my IP' and take note of the IP address
2. Launch CMD or the shell of your choice
3. Type ping YOUR.DDNS.ADDRESS.HERE and hit enter
   eg ping play.reallycoolservers.com
4. Take note of the output and refer to the below table

{% tabs %} {% tab title="Successful Ping" %}

C:\Users\x>ping play.reallycoolservers.com

Pinging play.reallycoolservers.com [123.123.123.123] with 32 bytes of data: 
Reply from 123.123.123.123: bytes=32 time<1ms TTL=64 
Reply from 123.123.123.123: bytes=32 time<1ms TTL=64 
Reply from 123.123.123.123: bytes=32 time<1ms TTL=64 
Reply from 123.123.123.123: bytes=32 time<1ms TTL=64

Ping statistics for 123.123.123.123: Packets: Sent = 4, Received = 4, Lost = 0 (0% loss), Approximate round trip times in milli-seconds: Minimum = 0ms, Maximum = 0ms, Average = 0ms

A server has responded to your pings, great!

1. Confirm that the IP address matches your Google result
   • If it matches, great! Skip to
   • If it doesn't match, there is an issue with your DDNS container. Review the logs for the container

Continue to the next step {% endtab %}

{% tab title="Could not find host" %}

C:\Users\x>ping play.reallycoolservers.com

Ping request could not find host play.reallycoolservers.com. Please check the name and try again.

Your DDNS config is incorrect OR you've made a typo in your ping command.

1. Firstly, review your ping command and ensure the address is correct
   • If it is correct, there is an issue with your DDNS container. Review the logs for that container. Feel free to refer to my existing dynamic-dns.md documentation
   • If you've made a typo in the address, redo the test with the correct address

This needs to be resolved before you can continue any further {% endtab %}

{% tab title="Resolves IP but fails to connect" %}

C:\Users\x>ping play.reallycoolservers.com

Pinging play.reallycoolservers.com [123.123.123.123] with 32 bytes of data:
Request timed out.
Request timed out.
Request timed out.
Request timed out.

Ping statistics for 123.123.123.123:
    Packets: Sent = 4, Received = 0, Lost = 4 (100% loss),

You have resolved an IP address but the server does not respond to pings

Confirm that the resolved IP address matches your public IP

• If the IP address matches, this isn't a bad thing - some firewalls are configured to NOT respond to pings as a security measure.
• If the IP address does not match, there is something wrong with your DDNS container. Review the logs for the container. Feel free to refer to my existing dynamic-dns.md documentation

This needs to be resolved before you can continue any further {% endtab %} {% endtabs %}

Narrow down the issue

There are multiple areas where this can go wrong. Let's narrow it down, please refer to the below image.

The above network map should be relatively similar to your home network. We have 4 devices,

1. Wings Node, where the game server is hosted
2. Your gaming PC
3. A Firewall / Modem / Router
4. friend's computer

Our end goal is for the purple line (friends computer to pterodactyl node) to work.

There are a few places that this line can fail,

1. Connecting to the Domain (DNS issue) or IP address
2. Bad port forwarding config in the modem
3. Bad firewall config in the Pterodactyl node
4. Bad game server installation config
5. ISP blocking the port or port forwarding completely
6. Your ISP uses CGNAT

Option 3 is the easiest to confirm;

To do this, we'll follow the orange line in the network map above

1. Get the LAN IP address for your Wings node. This is likely to start with 192.x.x.x, 10.x.x.x or 172.x.x.x
2. Connect to your game server via the internal IP:port, eg 192.168.1.20:25565

{% tabs %} {% tab title="I can join the server" %} Most likely your port forward or (IF you are using a domain) your Domains DNS is bad.

have your friend connect via your public IP address and server port, eg 1.2.3.4:25565

If your friends are connecting via IP, skip this step. Browse to this website to get your public IP address and ping your domain. If the IP does not match, the DNS is incorrect. If so, you most likely have a dynamic DNS address - refer to dynamic-dns.md for a solution. Alternatively, your ISP may provide a static IP address at an additional cost.

If connecting directly to your public IP fails, confirm your port forward rule applies to the

• correct local IP
• correct port

If it still fails to connect:

your ISP may be blocking port forwards. I would suggest doing some Googling on your router / modem model to confirm your port forward rule has the correct syntax as some modems are awkward. You may have luck searching for my modem model port forward minecraft server but if you have no luck, you will need to ring your ISP.

Your ISP may be using CGNAT. You will need to contact your ISP to have this resolved. I would recommend googling my isp name cgnat and reading the results. Port forwarding will NEVER work behind a CGNAT without additional and complex network infrastructure.

Extra: You can use this website to test if a port is open (waiting for connections). Minecraft is a great server to test for this, as there are plenty of tools for testing things, like this {% endtab %}

{% tab title="Unable to join the server" %} Firstly, lets confirm things are OK by

• Ping your server and confirm it responds
• Reboot your server

If all of the above is ok / has been done;

1. SSH onto your Pterodactyl node
2. Disable the firewall
   If you are using Ubuntu, the command is listed below
   sudo UFW disable
3. Attempt to connect to the server via the internal IP:port

If it works, you will need to allow the port/s through the Firewall rule. Please refer back to the documentation, this step is already outlined. You may have missed additional steps as well.

If this does not work,

• the game server is not running
• you are looking at the wrong server or
• you are looking at the wrong port

Refer back to Pterodactyl Panel and check if the server is running and on what ports {% endtab %} {% endtabs %}

Pterodactyl Panel errors

Error 500

Yeah its broken! Post on the Pterodactyl discord for assistance.

Wings Errors

FATAL: failed to configure docker environment error=Error response from daemon: Pool overlaps with other one on this address space

Wings has defaulted to a docker network range that is in-use. The easiest way to resolve this is to edit your config.yml file, per step #upload-configuration-file-to-wingsto include the below lines

docker:
  network:
    interfaces:
      v4:
        subnet: 172.31.0.0/16
        gateway: 172.31.0.1

Please note: The IP range for 172 is quite small - 172.16 to 172.31. You may be able to get away with using a /24 subnet or something outside of the range. If you use something outside of the range you may run into issues accessing the internet on your wings host doing this. You could also use a different range, like 192.168 or 10.x

Panel is unable to see Node

1. Start the Wings container if its not running

2. Check your docker logs, you should see something similar to below

   

3. Open your internet browser and navigate to hostname:port, you should see the below error;

   {"error":"The required authorization heads were not present in the request."}
   

If you get different messages, you may not have applied the config file correctly. Refer to creating-a-new-wings-node.md

Database issues

Create a new database - An unexpected error was encountered while processing this request. please try again

Have you set the HASHID variable per creating-a-new-panel.md documentation?

If not, please re-read the documentation as you may have missed other steps too...

Game is unable to connect to server database

Try connecting via IP. This may be a docker DNS issue.