--- title: "Minecraft Connection Refused: Find the Real Cause | ZCS" description: "Fix Minecraft server connection refused errors by checking the process, port, firewall, bind address and hosting rules in the right order." url: "https://www.zcraftstudios.com/blog/minecraft-server-connection-refused-fix" updated: "2026-10-20T07:16:50.972429+00:00" source: "ZCraft Studios" --- > Site index for AI agents: https://www.zcraftstudios.com/llms.txt (full reference: https://www.zcraftstudios.com/llms-full.txt). Every page is available as Markdown by adding `.md` to its URL or sending `Accept: text/markdown`. 1. [Home](https://www.zcraftstudios.com/) 2. [Blog](https://www.zcraftstudios.com/blog) 3. Minecraft Connection Refused: Find the Real Cause [ All posts](https://www.zcraftstudios.com/blog) # Minecraft Connection Refused: Find the Real Cause ZCraft StudiosOct 15, 2026Updated Oct 20, 2026 Fix Minecraft server connection refused errors by checking the process, port, firewall, bind address and hosting rules in the right order. ## In this guide - [First identify who can connect](#first-identify-who-can-connect) - [Step 1: Check the console, not just the panel button](#step-1-check-the-console-not-just-the-panel-button) - [Step 2: Confirm the address and port](#step-2-confirm-the-address-and-port) - [Step 3: Distinguish localhost, LAN and public addresses](#step-3-distinguish-localhost-lan-and-public-addresses) - [Step 4: Check the network path](#step-4-check-the-network-path) - [Step 5: Confirm that the server is actually listening](#step-5-confirm-that-the-server-is-actually-listening) - [Step 6: Verify the result](#step-6-verify-the-result) - [Frequently asked questions](#frequently-asked-questions) - [Related ZCraft guides](#related-zcraft-guides) ## Minecraft Server Connection Refused: Troubleshooting Guide **Quick answer:** Connection refused usually means the client's connection reached an address where no service accepted it. Check that the Minecraft server is running, the target host and port are correct, and the host/network allows the connection. It is not automatically a RAM problem. This guide covers Java Edition dedicated servers, including Paper and Purpur. A Bedrock server uses different networking requirements. ## First identify who can connect | Test | Likely direction | | --- | --- | | Nobody connects, even locally | Process not running, bad bind, wrong port | | Host machine connects, others cannot | Firewall, router or external address | | LAN works but internet fails | Port forwarding, host firewall or ISP limitations | | Only one player fails | Client network, DNS, wrong address or version-specific errors | The exact error matters. **Connection timed out** suggests traffic is not completing, whereas **Connection refused** often indicates a reachable destination without an accepting listener. DNS resolution errors are a different category. ## Step 1: Check the console, not just the panel button Open the server console. A green status indicator on a hosting panel is less reliable than a completed startup log. Look for a successful startup line and then check for any messages indicating that the address is already in use, a configuration could not load, or the process stopped. If the server exits during startup, follow the [crash-log reading guide](https://www.zcraftstudios.com/blog/minecraft-server-crash-report-guide) first. ## Step 2: Confirm the address and port Java Edition commonly uses TCP port **25565**, but many managed hosts assign different ports. Use the actual allocation shown by your host. On a dedicated server, check these properties: ``` server-port=25565 server-ip= ``` Leaving `server-ip` blank is usually appropriate unless your host specifically requires binding to an address. Do not put a website URL or a remote player's address into this property. Try connecting using the host's direct IP address and allocated port. If that works but the domain does not, inspect the DNS record and any SRV record. ## Step 3: Distinguish localhost, LAN and public addresses `localhost` points to the machine running the game client. It does **not** let a friend on another computer reach your server. For home hosting, devices on the same network generally connect through the host computer's LAN IP. Friends outside the network need a reachable public endpoint and correctly configured routing or a properly managed hosting provider. ## Step 4: Check the network path For a trusted managed host, first verify its published connection address. For a server you operate yourself, verify the host firewall allows inbound TCP traffic on the assigned game port and that upstream network controls match. Some internet connections use carrier-grade NAT or block inbound hosting traffic. Port forwarding alone cannot solve those restrictions. Ask your network administrator or ISP, or use a host with a public game endpoint. **Security:** Only expose the game listener that actually needs to be public. Never expose databases, administrative panels or proxy backend servers just to fix a connection error. ## Step 5: Confirm that the server is actually listening On a Linux host you administer, the read-only diagnostic command below displays listening TCP sockets: ``` ss -ltn ``` Look for your intended game port. If it is absent, inspect startup output and `server.properties` before adjusting firewall rules. If it is present but remote players still fail, check upstream routing and access restrictions. ## Step 6: Verify the result Test these in order: a connection from the server machine, another local device where applicable, and one remote user. Confirm each can join and stay connected after a server restart. Avoid changing five settings at once; record what solved it. ## Frequently asked questions ### Why can I join but my friend cannot? Your local client may be using localhost or a private LAN address. Your friend needs a routable endpoint and the correct port. ### Does adding RAM fix connection refused? Not unless a separate memory issue is preventing the process from starting. Look at the console first. ### Is this the same as “Failed to verify username”? No. Authentication failures occur later in the connection process. Review [Minecraft authentication methods](https://www.zcraftstudios.com/blog/minecraft-server-authentication-methods). ## Related ZCraft guides - [Create a Paper server](https://www.zcraftstudios.com/blog/how-to-create-a-minecraft-server-walkthrough) - [Firewall hardening](https://www.zcraftstudios.com/blog/minecraft-server-firewall-hardening) - [Choose a Minecraft server host](https://www.zcraftstudios.com/blog/choosing-minecraft-server-host) **Bottom line:** Identify the failing point in the connection path before changing host, Java or plugin settings. ### Related guide - [Custom domain and SRV record setup](https://www.zcraftstudios.com/blog/minecraft-server-dns-srv-record-guide) ## Continue reading - [How to Fix Minecraft Server Lag: Find the Cause, Then Fix It](https://www.zcraftstudios.com/blog/reduce-minecraft-server-lag) - [Find Minecraft Plugin Conflicts Without Losing Data](https://www.zcraftstudios.com/blog/minecraft-server-plugin-conflict-debugging) - [Read Minecraft Crash Reports and Find the Bad Plugin](https://www.zcraftstudios.com/blog/minecraft-server-crash-report-guide) [ Previous guide Minecraft Plugin Not Loading? Fix Red Plugins Fast](https://www.zcraftstudios.com/blog/minecraft-plugin-not-loading-fix)[ Next guide Minecraft RAM Errors: Invalid Max Heap Size and Xmx](https://www.zcraftstudios.com/blog/minecraft-java-heap-ram-errors)