diff options
Diffstat (limited to 'docs/hosting-a-server-with-northstar')
| -rw-r--r-- | docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md b/docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md new file mode 100644 index 0000000..db493f6 --- /dev/null +++ b/docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md @@ -0,0 +1,49 @@ +# Document is empty +`[error] Failed reading masterserver authentification response: encountered parse error 'The document is empty.'` + +The masterserver needs to request your gameserver for it to be authentified and registered. +This error means that masterserver can't access your server's tcp port. + +It can come from many reasons, but you can narrow them down using [Port scanning tools](#check-if-a-tcp-port-is-open). + +## If a scan on your external IP is successfull + +#### Your GameServer is out of date + +Check that your server is running on the latest Northstar release as it can sometimes include breaking changes. + +#### Mastserver is down + +Check Northstar's Discord for annoucements. if https://northstar.tf gives you a HTTP 523 error, that means that the masterserver is offline. + +#### Ports are not the same + +Your gameserver is configured to listen to a given TCP port. + +Masterserver needs to be able to contact your gameserver though that same port. + +## If a scan on your external IP isn't successfull + +#### Windows Firewall is blocking tcp ports + +In some cases Windows Firewall can prevent your ports to be exposed to your local network. +To fix this issue, make a rule to allow your server to listen on your network. +Disabling the firewall can also work, even if it's not reccomended. + +#### Router NAT configuration is incorrect + +If your port can be accessed from your local IP but not from your public IP, then it's very likely that your NAT rules aren't properly configured. + +#### CGNAT + +See [CGNAT](https://r2northstar.gitbook.io/r2northstar-wiki/hosting-a-server-with-northstar/prerequisites#cgnat) + +## Check if a tcp port is open + +To check if a tcp port is open, you can use online services like [canyouseeme](https://www.canyouseeme.org/) or use a command line tool. + +On Windows using Powershell the following command can detect if a port is accessible. + +`Test-NetConnection -ComputerName IP -Port PORT` + +Your server **must** be running while you scan the port. |