Back to Guides
TroubleshootingBeginner

How to Fix Minecraft Server Won't Start Error

Learn how to diagnose and resolve common issues that prevent your Minecraft server from starting up properly.

Blockhead Support Team
8 minutes
This guide covers the most common causes of Minecraft server startup failures. Follow the steps in order for the best results.
1

Check Java Installation

Minecraft servers require Java to run. Verify you have the correct Java version installed:

java -version

For Minecraft 1.17+, you need Java 17 or higher. For older versions, Java 8 works fine.

If Java is missing: Download from Adoptium.net and install the appropriate version.

2

Verify Server Files

Ensure all required server files are present in your server directory:

  • server.jar - The main server file
  • eula.txt - End User License Agreement
  • server.properties - Server configuration file

If server.jar is missing, download it from minecraft.net/download/server

3

Accept the EULA

Minecraft requires you to accept the End User License Agreement:

  1. Open eula.txt in a text editor
  2. Change eula=false to eula=true
  3. Save the file
The server will not start until you accept the EULA by setting this to true.
4

Check Port Availability

Minecraft servers use port 25565 by default. Make sure it's not already in use:

# Windows
netstat -an | findstr :25565

# Linux/Mac
netstat -an | grep :25565

If the port is in use, either stop the conflicting process or change the port in server.properties:

server-port=25566
5

Allocate Sufficient Memory

Ensure your server has enough RAM allocated. Use these startup commands:

# For 2GB RAM allocation
java -Xmx2G -Xms1G -jar server.jar nogui

# For 4GB RAM allocation
java -Xmx4G -Xms2G -jar server.jar nogui
Minimum recommended RAM: 2GB for vanilla, 4GB+ for modded servers.
6

Check Server Logs

If the server still won't start, check the logs for specific error messages:

  • Look for latest.log in the logs folder
  • Common errors include "Address already in use", "OutOfMemoryError", or "ClassNotFoundException"
  • Search for the specific error message online for targeted solutions
7

Common Solutions

Try these additional fixes if the above steps don't work:

  • Firewall: Temporarily disable firewall or add Java/Minecraft exceptions
  • Antivirus: Add server folder to antivirus exclusions
  • File permissions: Ensure Java has permission to read/write server files
  • Corrupt world: Try starting with a fresh world by renaming the world folder
If your server starts successfully, you should see "Done! For help, type help" in the console. Players can now connect using your server IP.

Need More Help?

Our support team is available 24/7 to help with any Minecraft server issues.