> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purpify.host/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot connection problems

> Find why Minecraft Bedrock cannot connect to a Purpify server by checking status, address, port, version, and network restrictions.

Most connection failures come from a stopped server, an incorrect address or port, a version mismatch, or a device that does not support external servers.

## Check the server

1. Open the Purpify control panel.
2. Confirm that the server status is running.
3. Read the newest console lines and confirm that startup completed without a fatal error.
4. Copy the current server address and port again.

If the server stops during startup, use [Troubleshoot a server that will not start](/troubleshooting/server-wont-start).

## Check the Minecraft server entry

In Minecraft Bedrock Edition, edit the saved server and verify:

* **Server Address** contains only the hostname or IP address.
* **Port** exactly matches the Purpify port.
* Neither field contains leading or trailing spaces.
* Minecraft is updated to a version compatible with the server.

Delete and recreate the saved server entry when you are unsure whether a hidden space or stale value is present.

## Check the device and network

Some consoles do not provide the same external-server workflow as desktop and mobile editions. Confirm that your device supports adding external Bedrock servers.

To isolate a local network problem:

1. Ask another player on a different network to connect.
2. Restart Minecraft and the device.
3. Disable a VPN or proxy temporarily and test again.
4. Allow Minecraft through local firewall or security software.

## Match the symptom

| Symptom                            | Next check                                                                |
| ---------------------------------- | ------------------------------------------------------------------------- |
| Server always appears offline      | Recopy the address and port, then confirm that startup completed.         |
| `Unable to connect to world`       | Check version compatibility and test from another network.                |
| Connection worked before a restart | Check whether the address or port changed.                                |
| One player cannot join             | Check that player's game version, device restrictions, and local network. |
| No players can join                | Check server status, console output, and the connection details.          |

## Test with a new world

If the server is running but nobody can connect after a world change, test a fresh world to find out whether the current world is causing the problem.

<Steps>
  <Step title="Back up the server">
    Create a [backup](/server/backups) so you can restore the current world and settings.
  </Step>

  <Step title="Install a fresh world">
    Stop the server, then use Purpify's [world installer](/server/upload-world) to install a new world file.
  </Step>

  <Step title="Start and test">
    Start the server and try to connect again. If the fresh world works, the original world or one of its add-ons is likely causing the problem.
  </Step>

  <Step title="Choose what to keep">
    Restore your backup if you need the original world. Then inspect its add-ons and compatibility before testing it again.
  </Step>
</Steps>

## Information to send support

Include:

* The server name or account-visible server ID
* The exact connection error
* The date and time of the failed attempt, including your time zone
* The Minecraft version and device type
* Whether another player can connect

Never send your password. Send the server address only through a private support channel.
