Cannot Connect to Server
Fix connection issues when you cannot join your Cafora Minecraft server.
Illustrated procedure
Screenshots show the current application with demonstration data. Use your own service details; click an image to inspect it at full size.
Check the console
Open Essentials → Console. Check the current state, startup output and errors before making changes. Wait for Done or your software’s ready message before joining.

Locate the file log
Under Files, double-click logs and locate latest.log. Check modification times. Preserve the relevant file before a restart replaces or rotates it.

Read the complete error context
Open the log in the editor and inspect the earliest relevant error and surrounding lines. Remove tokens, passwords and private player details before sharing. Do not diagnose from the last line alone.

Describe the request to support
Open a support ticket with the service or invoice ID and the requested action. For connection issues include time, error and MTR evidence. Never include passwords, tokens or card details.

Server-Side Checks
Is the Server Online?
- Check server status in the Pterodactyl Panel
- Look at the console for running status
- Try restarting the server
Correct Address?
- Verify the server address format
- If using a custom domain, check DNS configuration
- For SRV records, ensure the port is not required in the client
Minecraft Version Match
- Your client version must match or be compatible with the server version
- Check ViaVersion/ViaBackwards if using older clients with newer servers
Client-Side Checks
Common Error Messages
| Error | Meaning | Solution |
|---|---|---|
| Connection Refused | Server not accepting connections | Check if server is online |
| Connection Timed Out | Network cannot reach server | Check address, firewall, DNS |
| Unknown Host | Address cannot be resolved | Verify the server address |
| Invalid Session | Minecraft authentication issue | Restart your Minecraft launcher |
| Outdated Client/Server | Version mismatch | Update client or server |
Firewall Issues
- Your local firewall may be blocking Minecraft
- Try a different network (mobile hotspot) to isolate the issue
- Check if your ISP blocks gaming ports
Origin IP Is Not the Entry Address
Connecting directly to the origin IP will always fail — Minecraft ports on the origin IP are dropped by design. Always connect with the server hostname. See Server IP.
Advanced Checks
See the Connectivity Troubleshooting page for detailed network diagnostics.