Unknown Host

If you're attempting to connect to a server and get the Unknown Host error, it indicates that the client was unable to resolve the domain name of the server.

This error is very common and is casued by either a misconfiguration on the customer's side, or by the client not being able to resolve the domain name due to several reasons.

Why could this happen?

• The DNS record may not exist or be misconfigured.
• The DNS record wasn't fully propagated yet to the client's DNS resolver.
• The DNS server used by the client may be misconfigured, or malfunctioning.
• Your server may be blocked by Mojang's EULA enforcement.

How to fix it?

• Ensure that the DNS record exists and is correctly configured on your DNS nameservers, please refer to DNS for more information.
• Ensure that the DNS was fully propagated around the globe, please refer to a Propagation Checker for more information.
• Ensure that the DNS server used by the client is correctly configured, or use a more reliable DNS server such as 1.1.1.1 or 8.8.8.8.
• Ensure that there is no unwanted cached DNS answers on the client's side, please read below for more information.

How do I check if my server is blocked by Mojang?

The community has created a tool to check if your server is being blocked by Mojang due to EULA violations.

If you're blocked, you can contact Mojang's support team to submit an appeal, we will not be able to help you with this issue.

How do I clear my DNS cache?

Windows

1. First, you'll need to open the command prompt (press Win + R and type cmd to open it).
2. Next, you'll need to run the following command:

ipconfig /flushdns

3. Restart your client to avoid any caching issues and try connecting again.

MacOS

1. First, you'll need to open the terminal (press Cmd + Space and type terminal to open it).
2. Next, you'll need to run the following command:

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

3. Restart your client to avoid any caching issues and try connecting again.