How to Fix Unknown Host on a Minecraft Server
Fix Minecraft Unknown Host errors by checking domain spelling, DNS A records, SRV records, propagation, Cloudflare proxy status, and local DNS cache.
Unknown Host is a DNS problem. The client could not turn the server name into an address. That is different from a timeout, refused connection, or plugin kick.
Check the Hostname First
Ask the player to copy the exact address they used. These are different:
example.com
play.example.com
play.example.com:25565
mc.example.com
Typos, old subdomains, and hidden spaces are common. Test the same address yourself before changing records.
A Record vs SRV Record
| Setup | Required DNS |
| --- | --- |
| play.example.com on port 25565 | A record for play |
| play.example.com:25577 | A record for play, players include port |
| play.example.com on hidden port 25577 | A record for target plus SRV record |
If you want a clean domain without showing a custom port, use how to create an SRV record for Minecraft.
Cloudflare Proxy Status
For normal Minecraft Java servers, the DNS record should be DNS-only, not proxied through Cloudflare's standard HTTP proxy. In Cloudflare terms, that means the gray cloud for the Minecraft hostname.
The standard Cloudflare proxy is for web traffic. A proxied Minecraft hostname can fail or point players to the wrong service unless you use a product specifically built for that traffic type.
Read Cloudflare and Minecraft servers explained before changing a production domain.
Wait for DNS Propagation, But Verify the Record
Propagation is real, but it should not be used as a guess. Check whether the record exists and whether it points to the expected target. If one resolver sees the new record and another sees the old record, wait. If no resolver sees the record, the DNS entry is wrong or missing.
If IP Works but Domain Does Not
If players can join with the public IP but get Unknown Host on the domain, the Minecraft server is not the problem. Fix DNS records, SRV targets, spelling, or Cloudflare proxy status.
If both IP and domain fail, continue with fix can't connect to a Minecraft server.
FAQ
Does Unknown Host mean the Minecraft server is offline?
Not usually. Unknown Host means the name did not resolve to an address. The server may be running correctly.
Can Cloudflare cause Unknown Host?
Yes, if DNS records are missing, proxied incorrectly, or the SRV target points to a name that does not resolve.
Should I add a port to fix Unknown Host?
Only if the hostname resolves and the server uses a non-standard port. If DNS fails, adding a port will not fix the name.
Related Tools
server.properties Generator
Generate a clean Minecraft server.properties baseline for online mode, max players, difficulty, view distance, simulation distance, and command blocks.
Minecraft Port Checker / Troubleshooting Wizard
Build a Minecraft port troubleshooting plan for port 25565, home hosting, VPS firewalls, panel allocations, proxy networks, DNS, and CGNAT.
Backup Schedule Generator
Generate a Minecraft server backup schedule with interval, retention, storage estimate, off-node backup reminder, and cron-style examples.
Related Articles
How to Use a Domain for Your Minecraft Server
Set up a domain for your Minecraft server with A records, subdomains, SRV records, DNS-only Cloudflare settings, and correct public IP targeting.
How to Create an SRV Record for Minecraft Server
Create a Minecraft SRV record for Java servers using the correct _minecraft._tcp name, target hostname, port, priority, weight, and DNS-only settings.
Cloudflare and Minecraft Servers Explained
Understand Cloudflare with Minecraft servers: DNS-only records, orange-cloud proxy limits, SRV records, DDoS expectations, and common connection mistakes.