MinecraftSide
Guide

How to Fix Unknown Host in Minecraft

Learn what the Minecraft unknown host error means and fix it on Windows, macOS, or Linux with DNS, network, and server checks.

Editorial Team 7 min read
How to Fix Unknown Host in Minecraft

Understanding the Minecraft Unknown Host Error

The unknown host error means Minecraft cannot find the server address you entered. The game asks DNS to turn a host name into an IP address. DNS is the system that links names with server addresses.

So, what does unknown host mean in Minecraft? It means the lookup failed before Minecraft could start a connection. The server may still be online. Your device, router, DNS server, or the typed address may cause the failure.

First, check the address one character at a time. Remove extra spaces, check each dot, and confirm the port. A Java server may use an address like play.example.net. Bedrock may also need a separate port, such as 19132.

Do not confuse this error with a timed-out connection. A timeout means Minecraft found the host but got no reply. Unknown host points first to name lookup or an incorrect address.

Common Causes of the Unknown Host Message

Many cases come from a simple typing mistake. Server owners may also change their address after a host move. A server that uses a dynamic IP can fail when its name record is out of date.

Your network may also block or mishandle DNS requests. This can happen on public Wi-Fi, school networks, hotel networks, or some ISP links. A VPN can add another layer that breaks the lookup.

Voxel network path split between connected islands with glowing cyan and pink blocks
Common causes shown as a broken voxel path

Firewall rules can block Java, Bedrock, or the launcher. This cause is less common when the message says unknown host. Still, firewall checks matter after DNS works again.

Use this quick check before changing system settings:

  • Ask the server owner to confirm the current address.
  • Try the address on another network, such as a phone hotspot.
  • Restart Minecraft, your device, and your router.
  • Turn off a VPN or custom proxy for one test.
  • Check whether other websites load on the same device.

If the address fails on every device, the server owner should check the domain record. If it fails only on your device, focus on local DNS and network settings.

How to Fix Unknown Host on Windows

Windows lets you set a DNS server through the network adapter menu. Cloudflare lists 1.1.1.1 and 1.0.0.1 as its public DNS addresses. Google also offers 8.8.8.8 and 8.8.4.4.

Isometric voxel gateway tower with three glowing network paths on purple blocks
Windows DNS fix in a voxel scene
  1. Press Windows key and R together.
  2. Type ncpa.cpl, then press Enter.
  3. Right-click your active connection and choose Properties.
  4. Select Internet Protocol Version 4, then choose Properties.
  5. Choose the option for a preferred DNS server.
  6. Enter 1.1.1.1 as preferred and 1.0.0.1 as alternate.
  7. Save the change, then close every network window.

Next, clear old DNS data. Open Command Prompt as an administrator. Run ipconfig /flushdns, then restart Minecraft.

Test the server address in Command Prompt with nslookup play.example.net. Replace that sample name with the real server address. A working result should show one or more IP addresses.

If the lookup still fails, reset the network link. Run ipconfig /release, then ipconfig /renew. Restart the router if your device still cannot reach other sites.

For more detail, see Cloudflare's DNS setup guide. It covers public DNS setup across common systems.

How to Fix Unknown Host on macOS

macOS stores DNS choices in each network service. You can change them without installing any extra tool. The steps differ slightly between Wi-Fi and wired links.

Glowing cyan voxel archway linking a floating island in violet night fog
macOS DNS path through a voxel gateway
  1. Open the Apple menu and choose System Settings.
  2. Select Network from the left side.
  3. Choose Wi-Fi or Ethernet, then select Details.
  4. Open the DNS section and select the plus button.
  5. Add 1.1.1.1 and 1.0.0.1.
  6. Click OK, then choose Apply.

Older macOS versions use System Preferences. Choose Network, select your connection, and open Advanced. Add the same DNS addresses under the DNS tab.

Clear the local DNS cache after saving the change. Open Terminal and run sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder. Type your Mac password when asked.

Now test the server again. If it still fails, remove the server from Multiplayer and add it again. This rules out a saved address or port mistake.

Also test another network. A phone hotspot can show whether your home router or ISP causes the issue. Turn off iCloud Private Relay or a VPN for one test if enabled.

How to Fix Unknown Host on Linux

Linux DNS settings depend on your distribution and network tool. Many desktop systems use NetworkManager. Others use systemd-resolved or a manual resolver file.

Voxel terrain cutaway with underground cable channels and a glowing cyan portal core
Linux network route in a voxel cutaway

On Ubuntu with a desktop, open Settings and choose Wi-Fi or Network. Select the gear icon beside your active link. Open IPv4, set DNS to manual, and enter 1.1.1.1, 1.0.0.1. Save the change, then reconnect.

On many Linux systems, the command line offers a faster route:

  1. Run nmcli connection show to list network names.
  2. Find the active name, such as Wi-Fi.
  3. Run nmcli connection modify "Wi-Fi" ipv4.dns "1.1.1.1 1.0.0.1".
  4. Run nmcli connection up "Wi-Fi" to reconnect.

Replace Wi-Fi with your real connection name. Use resolvectl status to view the current DNS service. Then run resolvectl query play.example.net to test the server name.

If the command returns an IP address, DNS works. If Minecraft still fails, check the server address, port, firewall, and game version. A local firewall may block the game even after lookup succeeds.

Linux users with custom network tools should avoid editing resolver files without a backup. Network services may overwrite manual changes. Use the active tool, such as NetworkManager, when possible.

Network Troubleshooting When DNS Is Not the Problem

DNS changes cannot fix a dead server or a blocked network. Start by opening two or three normal websites. If they fail, fix the broader network link before testing Minecraft.

Restart your router and wait two minutes. Then reconnect the device. Test with a hotspot, because this separates home network faults from server faults.

  • Check the server status with its owner or official status page.
  • Confirm the game edition and server version match.
  • Check the server port, especially on Bedrock.
  • Allow Minecraft through the system firewall.
  • Disable VPN, proxy, and custom security filters briefly.
  • Ask your ISP whether it has a DNS outage.

Do not open random firewall ports as a first fix. Minecraft normally needs an outbound connection from your device. The server host controls inbound port rules.

If friends also see the error, report the issue to the server owner. They should check the domain record, host status, and server settings. If only you see it, keep working through local DNS and network checks.

Preventing Future Unknown Host Errors

Reliable DNS servers reduce lookup failures, but they cannot prevent every outage. Pick a known provider with a stable public service. Cloudflare, Google Public DNS, and your ISP are common choices.

Use two DNS addresses from the same provider when possible. This gives your device a backup path. You can compare providers with a simple test at different times of day.

DNS providerPreferred addressAlternate address
Cloudflare1.1.1.11.0.0.1
Google Public DNS8.8.8.88.8.4.4
Quad99.9.9.9149.112.112.112

Save trusted server addresses in a password manager or note app. Copy them instead of typing them by hand. Server names can also change, so follow the owner's latest update channel.

Keep your launcher and game version current. Old versions can create other connection errors that look similar. Finally, record the exact error and test result before asking for help.

The fastest path for how to fix unknown host Minecraft is simple. Check the address, test DNS, clear the cache, and try another network. Then check firewall rules and server status.

Step-by-step

  1. 01
    Check the server address

    Copy the address from the server owner. Check every character, dot, and port before changing system settings.

  2. 02
    Test your network

    Open other websites, then restart your router. Try a phone hotspot to separate home network faults from server faults.

  3. 03
    Change the DNS server

    Set two trusted DNS addresses for Windows, macOS, or Linux. Cloudflare uses 1.1.1.1 and 1.0.0.1.

  4. 04
    Clear the DNS cache

    Run the cache-clear command for your operating system. Restart Minecraft after the command finishes.

  5. 05
    Test the host name

    Use nslookup or resolvectl to check whether the name returns an IP address. If it does not, contact the server owner.

  6. 06
    Check local blocks

    Allow Minecraft through the firewall and disable VPN or proxy tools for one test. Recheck the server after each change.

Frequently asked questions

What does unknown host mean in Minecraft?
It means Minecraft cannot turn the server name into an IP address. The address may be wrong, or your DNS service may have failed.
Why does it say unknown host on Minecraft?
Common causes include a typing error, a changed server address, broken DNS, a VPN, or a blocked network. The server may also have a failed domain record.
How do I fix unknown host in Minecraft?
Check the address and port first. Then change DNS, clear the DNS cache, restart your network, and test the server on another connection.
How do I fix unknown host on a Minecraft server?
Confirm the current server address with its owner. If the address fails for everyone, the owner should check the domain record and hosting service.
Which DNS server is best for Minecraft?
Cloudflare, Google Public DNS, and Quad9 are trusted choices. Speed can vary by location, so test two providers on your own network.
Can a firewall cause an unknown host error in Minecraft?
A firewall more often causes a timeout or refused connection. Still, allow Minecraft through the firewall after you confirm that DNS works.
unknown host errorMinecraft DNS settingsfix Minecraft server connectionserver address lookupMinecraft network issueschange DNS serverMinecraft connection errorsserver port settings

Related reading