Guides · Minecraft servers
Can't join · won't start
Status → console errors → version, plugins, world, in that order.
1. Check status first
Service page → Server status. If off, press Start. If starting, wait 1–2 minutes (longer for modpacks).
| Message | Action |
|---|---|
Unknown host · Can't resolve hostname | Check the address. Custom domain DNS may take minutes to hours |
Connection refused · Connection timed out | Server off or starting → check status |
Outdated client · Outdated server · Incompatible | Match your game version to the server |
You are not white-listed | Console: whitelist add playerName |
You are banned | Console: pardon playerName |
Failed to verify username · Invalid session | Sign out and back in through the launcher |
| Mod list mismatch | Install the same loader and mods as the server (Modded servers) |
Bedrock (mobile or console) cannot connect.
3. Server will not start
The service page shows the cause and suggested action. Buttons: Change version · Restore a saved world · Start a new world · Open panel.
| Cause | Action |
|---|---|
| Wrong Java version · damaged server jar | Reinstall the same version under Version · reset |
| World newer than the server | Upgrade to the world's version or newer · or start a new world |
| Damaged world | Restore a saved world or panel backup |
| Plugin or mod error · dependencies | Remove the file · use a compatible version · install missing dependencies |
| Config error | Fix the named file · deleting it generates a new one |
| Cannot bind port | Leave server-ip empty · server-port=25565 |
| Out of memory | Fewer plugins or mods · lower view distance · larger plan |
| Watchdog timeout · crash | Check the named plugin or mod · crash-reports |
| Datapack error | Remove that datapack from world/datapacks |
4. Read the console
- Panel → Console.
- Read upwards from the bottom for
ERROR·Exception·Caused by. - The plugin, mod or file named there is often the cause.
- Older logs: Files →
logs/latest.log·crash-reports.
5. Still stuck
- Remove recent plugins or mods one at a time.
- Restore the last backup (Backups).
- Support request: service name · when it started · console error lines.