Fix Minecraft server connection problems

Use the error message and server state to identify whether the problem is the address, edition, version, port, whitelist, server process, network, or recent configuration.

Published by PortalMine Operations & Documentation TeamReviewed July 13, 2026Reading time: 8–12 minutes

Start with the exact error

“It does not work” can describe many different failures. Copy the exact message and note whether the problem affects one player or everyone. Also record whether the dashboard says installing, offline, starting, online, stopping, or error.

Error or symptomLikely areaFirst checks
Connection refusedServer offline, wrong port, process not listeningConfirm online state and exact connection details.
Connection timed outRouting, firewall, wrong address, overloaded or unreachable serverTest another network and confirm status/logs.
Unknown hostHostname typo or DNS problemPaste the address again without spaces or web prefixes.
Outdated client/serverVersion mismatchMatch the client and server version.
Not whitelistedAccess controlAdd the correct player name or disable whitelist intentionally.
Authentication/session errorClient login or online-mode authenticationRestart the client and use a valid authenticated session.

Universal checklist

  1. Verify the server is online

    “Created” does not always mean “ready.” Wait for installation and startup to complete.

  2. Confirm edition

    Java clients cannot normally join a Bedrock/Nukkit server, and Bedrock clients cannot normally join a Java server.

  3. Copy the address again

    Do not include https://, trailing punctuation, or spaces.

  4. Check the Bedrock port

    Use the exact port from the dashboard rather than assuming a default.

  5. Match versions

    Compare the full client and server version information.

  6. Check access controls

    Review whitelist, bans, operator settings, and plugin-based permissions.

  7. Review recent logs

    Look for a successful startup line or a clear plugin/configuration failure.

  8. Test without recent changes

    Remove the newest plugin or restore the previous configuration if the issue began immediately afterward.

Only one player cannot join

The problem is likely on that player’s client, account session, version, DNS, local firewall, network, or whitelist entry. Ask the player to restart the game, verify edition/version, re-enter the address, and test another network.

Nobody can join

Focus on server state, startup logs, address/port, platform status, firewall/routing, and recent server-side changes. Repeated restart clicks can make diagnosis harder.

Information for support

Send the exact error, edition, client version, server version, address format without exposing private credentials, time of failure, whether other players are affected, and the most recent relevant log lines. Never send your password.

Connection decision table

SymptomMost useful distinctionFirst test
Connection refusedHost reachable but nothing accepts the portConfirm server status and listening port
Timed outNo usable response reached the clientTest route, firewall, protocol and second network
Outdated / incompatibleProtocol or game version mismatchCompare exact client and server versions
Failed to verify usernameJava identity authentication failedCheck online mode, service status and system time
Only one player failsClient, route, account or local firewallTest a second account/device on the same network
Everyone fails after changeServer setting, software, firewall or updateRoll back the most recent controlled change

Collect evidence before restarting

Record the exact message, player edition, game version, address, port, server status, and timestamp. Copy the first relevant console error. A restart can make the symptom disappear temporarily while removing the original evidence.

DNS and address checks

A domain can resolve to the wrong IP, and an SRV record can point to an old host or port. Test the direct host and port shown by PortalMine, then compare it with the public domain. Bedrock players usually need the displayed port; Java clients can use an SRV record only when it is configured correctly.

Escalation checklist

  • Server type and version
  • Exact error text
  • Approximate time and timezone
  • Whether one or all players are affected
  • Networks already tested
  • Recent software, configuration, DNS, or plugin change