Give Your Minecraft Server a Custom Address
By default, players join your Minecraft server with the address shown at the top of its page, in the form node-name:port (for example node.example.com:25570). This article explains how to replace it with a simpler address that needs no port: a free subdomain provided by FreshPerf, or your own domain name.
Note: this article covers Minecraft Java Edition. Bedrock players (for example through Geyser) do not read SRV records: see Bedrock players.
How it works: the SRV record
For the address a player types, Minecraft Java looks up a DNS record of type SRV named _minecraft._tcp.<address>. That record holds the real server name and its port: the player only types my-server.enderman.fr, and the game connects to the right node and port on its own.
This is exactly what FreshPerf creates for you with a subdomain. You can also create it yourself at your registrar to use your own domain.
1. Create a FreshPerf subdomain
- Sign in to your FreshPerf client area.
- Open Services, then your Minecraft server.
- Open the Management tab, then Network.
- In the Subdomain card, type the name you want.
- Pick the domain from the list (for example
enderman.fr). The Preview line shows the final address. - Click Create.
The Subdomain active message confirms the creation, and the card shows the Current address with a button to copy it. Give this address to your players: they add it under Multiplayer, without a port.
The name must follow these rules:
- 3 to 32 characters.
- lowercase letters, digits and hyphens only.
- start and end with a letter or a digit.
Some names are reserved or already taken: just pick another one.
Change or remove the subdomain
- To change the name or the domain, edit the fields, then click Update.
- To remove it, click Remove and confirm. Players will no longer reach the server by this name.
Note: if you change the server's primary port in Network allocations, the FreshPerf subdomain is updated automatically.
2. Use your own domain name
You can also point a name from your own domain, for example play.example.com, at your server. This is done in your domain's DNS zone, at your registrar or DNS provider (OVHcloud, Cloudflare, Gandi…).
Find the node name and the port
At the top of your server's page (or under Management → Network → Network allocations), note the primary address, for example node.example.com:25570:
- the part before
:is the target (node.example.com). - the part after
:is the port (25570).
Create the SRV record
In your DNS zone, add an SRV record with these values:
| Field | Value |
|---|---|
| Service | _minecraft |
| Protocol | _tcp |
| Name | play (the subdomain you want) |
| Priority | 0 |
| Weight | 5 |
| Port | your server's port, for example 25570 |
| Target | the node name, for example node.example.com |
Depending on the registrar, the service and protocol go in separate fields, or straight into the name: _minecraft._tcp.play. The complete record looks like this:
_minecraft._tcp.play.example.com. 3600 IN SRV 0 5 25570 node.example.com.
⚠️ Warning: the target of an SRV record must be a name, never an IP address. If your server's address is shown as an IP, first create an A record (for example
mc.example.com→192.0.2.10), then usemc.example.comas the target. At Cloudflare, keep that A record DNS only (grey cloud): the Cloudflare proxy does not carry Minecraft traffic.
Check the record
After a few minutes, check that the record is visible.
On Windows:
nslookup -type=SRV _minecraft._tcp.play.example.com
On macOS or Linux:
dig SRV _minecraft._tcp.play.example.com
The answer must contain your port and the node name.
Note: unlike the FreshPerf subdomain, a record created at your registrar is not updated automatically. If your server's primary port changes, update it in your DNS zone too.
Bedrock players
Minecraft Bedrock Edition does not read SRV records. The FreshPerf subdomain relies on an SRV record only, so it does not work for Bedrock players (for example through Geyser).
With your own domain, however, you can give them an address. In your DNS zone, add a CNAME record pointing at the node name:
| Type | Name | Value |
|---|---|---|
| CNAME | play | the node name, for example node.example.com |
An A record pointing at the server's IP address (play → 192.0.2.10) works too, but the CNAME saves you from copying the IP address. At Cloudflare, keep this record DNS only (grey cloud).
An A or CNAME record carries no port: Bedrock players type play.example.com as the address, and the Bedrock port configured for Geyser in the Port field.
The same name can serve both editions: Java players go through the SRV record _minecraft._tcp.play.example.com, without a port, and Bedrock players through the CNAME play.example.com, with the Bedrock port.
Troubleshooting
Find the situation that matches your problem below.
Connection refused: getsockopt or Connection timed out: getsockopt
- Check that the server is Online in the client area.
- Try to connect with the direct address shown at the top of the page (
node.example.com:25570). - If the direct address works but the subdomain does not, the record is not visible from your computer yet or it is misconfigured: wait a few minutes, restart Minecraft, then check the record as explained above.
- Check that you are using Minecraft Java Edition.
The subdomain is refused
The name is already in use, reserved, or does not follow the format. Pick another name.
The problem persists
Contact FreshPerf support and mention the address you are using.