HytalePublished on January 17, 20264 min read

Configure a domain on Hytale server: DNS tutorial

A domain name makes your Hytale server address easier to remember, for example play.yourdomain.com. This guide explains how to configure a domain on a Hytale server hosted at OuiHeberg, with a CNAME or A DNS record. You need a domain name and access to its DNS zone.


Hytale's current limitation

The Hytale server does not support SRV records yet, which are used to hide the port. Your players will therefore need to add the port after your domain name to connect.

yourdomain.com:12345

This limitation may be lifted in a future game update. The last section of this guide explains how to do without the port today.


Find your server address

In the client area

  1. Log in to your OuiHeberg client area.

  2. In My services, click your Hytale server to open its page.

  3. Note its Connection address. It is an alias such as gmXX-dcXX.ouiheberg.com:port. When there is no alias, it is the IP address followed by the port.

Server page in the client area with the Connection address line highlighted

In OuiPanel

In your server's Console, the "Connection information" card shows the same details. IP Alias gives the alias and port, Encrypted IP gives the IP address and port.

  • The alias, for example gmXX-dcXX.ouiheberg.com, is used for the CNAME record.

  • The port, for example 12345, is added to the domain to connect.

  • The IP address, for example 203.0.113.10, is only needed for an A record.

The same card offers Create my own domain name, with an Order button to buy a domain.

OuiPanel Connection information card with Encrypted IP and IP Alias


Open your domain's DNS zone

Go to your registrar's interface (OVH, Cloudflare, Gandi, OuiHeberg…) and open the domain's DNS zone.

Is your domain with OuiHeberg? In My services, select the Domains filter, then click your domain. On its page, open the DNS zone section. The zone can only be managed here if the domain uses the OuiHeberg nameservers. The Nameservers section tells you which ones it uses. The guide How to edit the DNS records of your domain covers each record type.

Domain page in the client area with the DNS zone section and Add button


Create a CNAME record

We recommend a CNAME record pointing to your server's alias. If the IP address behind the alias changes, your domain follows with no change on your side. Add a record with these settings.

FieldValue
TypeCNAME
Name / Subdomainplay (or hytale, as you prefer)
Value / TargetYour server's alias, without the port (for example gmXX-dcXX.ouiheberg.com)
TTLDefault value

To use play.yourdomain.com, the name is play. For hytale.yourdomain.com, the name is hytale.

At OuiHeberg

  1. In the DNS zone section, click Add.

  2. In the "Add a record" window, keep the Manual template.

  3. Choose the CNAME type, fill in Name and Value, then click Add.

The default TTL equals 4 hours. The list goes from 5 minutes to 24 hours.

Add a record window with a CNAME play pointing to the server alias

Or an A record

A CNAME cannot be placed on the domain itself (@). To use yourdomain.com without a subdomain, create an A record. Enter @ as the name and the server's IP address as the value.

To find this address, resolve the alias with the following command, or read the Encrypted IP line in OuiPanel.

nslookup gmXX-dcXX.ouiheberg.com

At Cloudflare, you create the A record with the A type, the name (play, or @ for the domain) and the address in IPv4 address. Leave Proxy status on DNS only, because the Cloudflare proxy does not pass game traffic.

An A record does not follow a change of IP address. If the server's IP changes, update the record yourself.


Wait for propagation and test

DNS propagation takes from a few minutes to 24 hours depending on the registrar. It usually takes between 15 minutes and 2 hours. The dnschecker.org tool shows how far propagation has gone.

Once it is done, your players join the server with the domain followed by the port.

your-domain.com:PORT

For example play.yourserver.com:12345. The guide How to join a Hytale server shows where to enter this address in the game.


Connect without the port

Hytale uses port 5520 by default. For your players to connect with just yourdomain.com, two conditions must be met.

  1. The server has a dedicated IP address.

  2. It listens on port 5520, Hytale's default port.

The game then uses that port on its own, and the domain is enough.


Need help?

Open a ticket from Tickets › Open a Ticket, or from the Contact support tile at the bottom of your server's page in the client area. You can also ask your question on the OuiHeberg Discord.

Was this article helpful?

654 views
Share this article
Hytale
Need a Hytale server?

Hytale server hosting from $3.46/month, with CurseForge mods installed from the panel and DDoS protection included.

View plans →
Hytale
Need a Hytale server?

Hytale server hosting from $3.46/month, with CurseForge mods installed from the panel and DDoS protection included.

View plans →

Related Articles