Cannot join a Minecraft server: connection troubleshooting

Has the server finished starting?

Open the hosting console. A process marked online may still be loading or fail shortly afterwards. Read the end of startup and the first meaningful error: incompatible Java, missing files, invalid settings or a port conflict.

If the server stops, fix that failure before changing the router. If a plugin was just added, investigate on a backed-up test copy rather than deleting world data.

Use the error to choose a test

• Connection refused: a destination or network device rejected the connection. Check the listening service, port and filtering.
• Connection timed out: no usable response arrived in time. Check public address, routing and firewall without assuming a single cause.
• Unknown host: investigate the hostname and DNS resolution.
• Incompatible version: compare game versions and server software before changing networking.
• Whitelist or access denied: the server responded; inspect account and access rules.

These messages guide investigation rather than conclusively identifying the failing component.

Test the actual game endpoint

For Java, use the game IP and port supplied by the provider, not SFTP or a web-panel port. For a home server, an outside friend needs a reachable public address; a private LAN address normally works only within your network.

Check that router forwarding points at the correct computer and that its firewall allows the game service. If the internet connection does not provide a reachable public address, ask the ISP about available options or consider external hosting. Do not disable the firewall globally as a workaround.

Separate DNS, Java and Bedrock

If the IP works but the hostname fails, inspect A and SRV records and DNS caches. If Java works while Bedrock fails, check Geyser and its UDP allocation. The Java TCP port does not establish that the Bedrock endpoint is working.

For one affected player, compare edition, versions and mods with a working player. Then test another network to separate the local installation from internet connectivity.

Send useful evidence to support

Provide the exact error, timestamp, game port, versions and test results. Remove passwords, keys and private data from logs. Home-network limitations can justify rented hosting; an incompatible client version should first be corrected in the game installation.

Frequently asked questions