Minecraft SRV record: format, port and troubleshooting

An SRV record tells Minecraft Java on which host and port your server lives. Players type myproject.aclclouds.online with no port, even if the server listens on 25570. This guide covers the format of the _minecraft._tcp SRV record, how to create it in the DNS dashboard of an ACLClouds subdomain, the Bedrock case, which ignores SRV, and the most frequent failures.

The essentials

  • The _minecraft._tcp SRV record gives the port and the host: Java players no longer type a port.
  • Format: priority 0, weight 5, server port, target = a name with an A or AAAA, never an IP.
  • Bedrock ignores SRV records: address (A or AAAA) plus UDP port, 19132 by default.
  • DNS correct but no connection: look at the listening port and the firewall.
ACLClouds
ACLClouds

Minecraft SRV record: format, port and troubleshooting

Create the _minecraft._tcp SRV record on a subdomain: priority, weight, port and target, Bedrock with an A or AAAA, then the common errors to fix.

An SRV record tells Minecraft Java on which host and port your server lives. Players type myproject.aclclouds.online with no port, even if the server listens on 25570. This guide covers the format of the _minecraft._tcp SRV record, how to create it in the DNS dashboard of an ACLClouds subdomain, the Bedrock case, which ignores SRV, and the most frequent failures.

  • The _minecraft._tcp SRV record gives the port and the host: Java players no longer type a port.
  • Format: priority 0, weight 5, server port, target = a name with an A or AAAA, never an IP.
  • Bedrock ignores SRV records: address (A or AAAA) plus UDP port, 19132 by default.
  • DNS correct but no connection: look at the listening port and the firewall.

What an SRV record contains

The name of a Minecraft SRV record is always _minecraft._tcp, followed by the name players will type. Its value holds four fields: the priority (0 is enough), the weight (0 or 5, only useful with several SRV records), the server port and the target, a host name that itself has an A or AAAA record.

  • Example: _minecraft._tcp.myproject.aclclouds.online → 0 5 25570 play.myproject.aclclouds.online.
  • The target is a name, never an IP address, and that name must not be a CNAME.
  • Without an SRV record, the Minecraft Java client uses port 25565 and the A record of the name typed.

Create the SRV record in the DNS dashboard

In the ACLClouds client area, open your subdomain, then its DNS zone. First add an A record named play with the server’s public IPv4 (an AAAA for IPv6). Then add a record of type SRV: name _minecraft._tcp, priority 0, value “weight port target”, for example 5 25570 play.myproject.aclclouds.online. The “Minecraft (SRV)” preset fills these fields for you: just give the target and the port.

  • The name of an SRV record must start with _service._tcp (or _udp, _tls) and the priority is required, from 0 to 65535.
  • The TTL is automatic or between 60 seconds and 1 day; a subdomain accepts up to 50 records.
  • These records are created on an ACLClouds free subdomain the same way as on a domain of your own: the steps are identical.
  • If the server already listens on 25565, an A on @ is enough: see the free subdomain guide for Minecraft.

Bedrock: A or AAAA and port 19132

The Minecraft Bedrock client (consoles, mobile, Windows) does not read SRV records. For these players, create an A (or AAAA) named bedrock, or reuse play, then share the address and the server’s UDP port, 19132 by default. A Java server running Geyser uses both: the SRV record for Java, the address and port for Bedrock.

  • Bedrock: the address goes in “Server Address” and the port in “Port”, two separate fields.
  • The Bedrock port is UDP: open it in the firewall in addition to the Java TCP port.
  • On an ACLClouds Minecraft server, the IP address and assigned ports are shown in the server panel: see Minecraft hosting.

Check resolution

Before launching the game, query the DNS: dig _minecraft._tcp.myproject.aclclouds.online SRV must return the line 0 5 25570 play.myproject.aclclouds.online, then dig play.myproject.aclclouds.online A must return the server IP. On Windows, nslookup -type=SRV _minecraft._tcp.myproject.aclclouds.online gives the same result.

  • New records are visible within a few minutes; an old record stays cached until the end of its TTL.
  • In Minecraft, type the name alone: name:port ignores the SRV record and forces the given port.
  • Test that the port is open with nc -vz IP 25570, or Test-NetConnection in PowerShell.

Fix the common errors

When DNS answers correctly but the connection fails, the cause is almost always the port or the firewall, not the record. Here are the Java client messages and their fix.

  • “Can’t resolve hostname”: the typed name has neither A nor SRV, or contains a typo; check the zone and wait for propagation.
  • “Connection refused”: DNS points to the right IP but nothing listens on that port; check server-port in server.properties and that the server is started.
  • “Connection timed out”: the port is closed by the machine’s or the host’s firewall; open it in TCP (Java) and UDP (Bedrock).
  • SRV refused at creation: name without _minecraft._tcp, missing priority, target written as an IP or name already holding a CNAME.
  • Bedrock players stuck: they cannot use the SRV record; give them the address and port 19132 (or the Geyser one). For the difference between types, read the DNS records guide.

Frequently asked questions

Do I need an SRV record if my server uses port 25565?

No. Minecraft Java tries port 25565 by default: an A record on the name is enough. The SRV record is for a different port, or when the real host has another name.

Can I put the IP address as the SRV target?

No. The target of an SRV record is a host name. First create an A (or AAAA) to the IP, then give that name as the target.

Why do my Bedrock players have to type the port?

Because the Bedrock client does not read SRV records. The address and the port must be entered separately, 19132 by default.

Do I need a paid domain name for a Minecraft SRV record?

No. An ACLClouds free subdomain accepts A, AAAA and SRV records, up to 50 per subdomain. A paid domain is only useful for a name of your own.