How to fix connection errors on a Bedrock server¶

If a player cannot join a Bedrock server, work through the following checks in order.

Basic checklist¶

• Make sure the server is online.
• Make sure the IP and port the player is using match what is shown in the panel.
• Make sure the client version matches the server version.

Check server.properties¶

Some important settings to review:

server-port=19132
online-mode=true
allow-list=false

Adjust the values to suit your server.

Common causes of failed joins¶

Version mismatch¶

• An Outdated Client or Outdated Server message means the versions are not in sync.

Allowlist is enabled¶

• If allow-list=true, players must be added to the allowlist.

Wrong port¶

• Make sure the port the player is using matches the port shown in the panel, not just the default Bedrock port.

Server has not finished booting¶

• Wait until the console shows the server is ready to accept connections.

Avoid generic "fixes"¶

Setting online-mode=false is not a universal solution to every connection error. For public servers, the official Bedrock documentation actually recommends online-mode=true.

If it still fails¶

• Copy the error from the console.
• Note the IP, port, and client version used.
• Contact support with your Server ID and the error details.

Cheers, Team NexusCloud