Can't connect errors

Server is green on the panel but players can't join. Each error message has a specific meaning — this guide translates the cryptic ones, splits "your fault" from "their fault," and walks the fixes.

Troubleshooting Last updated May 19, 2026 ~6 min read

First checks (do these before anything else)

  1. Is the server actually online? Open the dashboard — status pill should be green. If grey/red, see Server won't start.
  2. Are you using the right address? Copy it from Server Address on the dashboard. Not from an old email, not from memory.
  3. Does it work for anyone? If you can connect but a friend can't, it's almost always client-side or ISP routing. If nobody can, it's almost always server-side.

"Can't reach server"

Generic catch-all from the Minecraft client. Usually means the IP / port the client sent its connection request to never replied. Causes, ranked:

"Connection timed out"

The client sent a TCP SYN, the server never replied. Three suspects:

terminal
tracert play.myserver.com         # Windows
traceroute play.myserver.com      # Mac/Linux

"Connection refused"

Different from timeout — the server did reply, but said "go away." Causes:

"Outdated server" / "Outdated client"

Minecraft client and server protocol versions don't match. Two flavours:

Find the server's version: dashboard → console → type version.

ViaVersion saves the day

Install ViaVersion (and optionally ViaBackwards / ViaRewind) on Paper or Purpur servers and clients on different MC versions can join the same server. Doesn't work for modded servers — every player needs the same modpack.

"You are not white-listed"

Means exactly what it says — the whitelist is on and the joining player isn't on it. Three sub-cases:

"You are banned from this server"

Player is on the banlist. List bans with banlist, unban with pardon <Name> from the console.

If the player insists they were never banned: check banned-ips.json — sometimes a shared IP catches an innocent. Edit the file (server stopped first) and remove the offending entry.

"Server is full"

You've hit max-players in server.properties. Two fixes:

If the server is empty but still says "full", check that max-players isn't accidentally 0 or -1.

"Bad login" / "Failed to verify username"

Mojang's auth servers couldn't verify the joining account. Causes:

"This server is running [X], you have [Y]"

Modded only. The client's modpack doesn't match the server's. Either:

For private packs (CurseForge upload), share the export with players directly. For public ones (ATM, FTB, Prominence), point them at the matching CurseForge page.

"Flying is not enabled on this server"

Vanilla anti-cheat kicks players moving suspiciously. Common false-positive triggers:

In server.properties, set allow-flight=true. If you're using a separate anti-cheat plugin, tune its flight check instead.

"Internal Exception: ..."

Net-level error. The most common variants:

Single players hitting these = their connection. Many players at once = check the server's status, restart if needed.

Bedrock players can't connect

Bedrock clients use a different protocol entirely. They can only connect if you've installed Geyser (translates Bedrock ↔ Java) — see Adding plugins. Once Geyser is in, share the address shown by /geyser version with your Bedrock friends; the port is usually 19132.

Still stuck? Open a ticket with the exact error text, the affected player's country, and the last 50 lines of your console.