✦ Networking

Hytale Server Port Forwarding and Firewall Guide

A safe, layer-by-layer method to make a local Hytale server reachable without disabling protection or exposing unnecessary services.

Hytale characters travelling through a landscape, illustrating an external connection reaching a server
A public connection must pass every network layer, not only the router.
Quick answer

Hytale Port Forwarding & Firewall Guide

Confirm the server works locally, reserve a stable local IP, allow the configured UDP port in the host firewall, forward the same UDP port in the router, and test from an external network. The official default is UDP 5520. If the router has no public IPv4 address, investigate CGNAT, double NAT, or provider firewall rules.

Port forwarding fails when only one network layer is configured. The server process, operating-system firewall, router, upstream modem, hosting provider, and internet provider can each block the connection.

Follow the layers in order. Changing several rules at once makes diagnosis harder and often leads people to disable security unnecessarily.

1. Prove the server works locally

Before touching the router, start the server and connect from the same computer or another device on the local network. If local access fails, port forwarding cannot fix the server process, wrong bind address, or startup error.

Confirm the actual port in the server configuration. This guide uses the official default, UDP 5520, but your configured value is the source of truth.

2. Use the correct protocol and port

The official manual describes Hytale server traffic over QUIC using UDP. A TCP-only rule will not replace the UDP rule. Configure only the port the server uses, unless another documented service needs a separate rule.

Keep the internal and external port identical while troubleshooting. Port translation can work, but it adds another value that can be mistyped.

3. Give the host a stable local address

A router forwards traffic to a private address such as 192.168.x.x. If DHCP later assigns a different address, the rule will point to the wrong device.

Prefer a DHCP reservation in the router for the server's network adapter. It is usually easier to maintain than a manually configured static address, especially when DNS and gateway values change.

4. Allow the server in the host firewall

Create a narrow inbound UDP rule for the configured port and, where supported, restrict it to the server executable or service account. Keep network profiles in mind: a rule enabled only for a private profile may not apply if Windows marks the connection as public.

Do not solve the problem by turning the firewall off. A successful test with the firewall disabled only tells you which layer needs a correct rule.

  • Windows: create an inbound UDP port or program rule.
  • Linux: add the UDP port to the active firewall system, such as UFW or firewalld.
  • Hosted server: also check the provider's security group or network firewall.

5. Forward the port in the router

In the router interface, create a UDP forward from the public port to the reserved local IP and the same internal port. Labels vary: Port Forwarding, NAT, Virtual Server, or Gaming.

Avoid DMZ mode and broad port ranges. Save the rule, confirm it is enabled, and restart only the router components that explicitly require it.

6. Test from outside your network

Many routers do not support NAT loopback, so testing your public address from inside the same Wi-Fi can fail even when external access works. Ask a trusted person to connect or use a phone on mobile data.

Generic web port checkers often test TCP and can report a false negative for a UDP service. The most meaningful test is an actual Hytale client reaching the running server.

7. Detect CGNAT and double NAT

Compare the router's WAN address with the public address shown by a reputable IP service. If they differ, or the WAN address is private/shared space, another NAT layer may exist.

Double NAT can come from an ISP modem plus your own router; forward the port on both or place one device in an appropriate bridge mode. With CGNAT, you may need a public IPv4 option, supported IPv6 path, VPN tunnel, or a hosting provider.

8. Keep the exposure limited

Patch the operating system, keep the server updated, use strong administrative credentials, and monitor logs. Do not publish management panels or remote desktop ports alongside the game port unless you fully understand their security.

Use HyTools to generate a checklist for your platform and save the final values with your server documentation.

Tools

Use these HyTools utilities

Continue with the browser tools referenced in this guide. No account or installation is required.

Port & Firewall Helper

Generate UDP 5520 firewall commands and follow Hytale port forwarding guidance for Windows, Linux, home routers, VPS providers, and local networks.

Server Configuration Assistant

Generate and validate Hytale config.json, JVM options and launch files. Import an existing config and download a complete local setup package.

Log Analyzer

Analyze Hytale server logs in your browser, highlight errors and warnings, navigate stack traces and generate a cleaner support report.

Frequently asked questions

Is the Hytale server port TCP or UDP?

The current official manual describes the default game port as UDP 5520 and the server transport as QUIC over UDP. Verify the current manual and your own configuration.

Why can I connect locally but friends cannot?

The server itself is probably running, but one external layer is blocking traffic: host firewall, router forwarding, provider firewall, double NAT, or CGNAT.

Should I disable the firewall to test?

A brief controlled test can isolate the layer, but do not leave it disabled. Create a narrow UDP rule for the actual server port.

Sources and further reading

Technical facts are checked against official Hytale material when available. Product behavior can change, so verify critical production changes in the current official documentation.

Article image: official Hytale media, © Hypixel Studios. Hytale Media