java.lang.IllegalStateException: Failed to initialize server

Understanding the Error

The java.lang.IllegalStateException: Failed to initialize server is a generic error triggered when the Minecraft server process encounters a critical failure during its startup sequence. It indicates that the server cannot complete its initialisation, usually due to corrupted configuration files, incompatible plugins, or missing dependencies.

How to fix it

1. Check the latest log file

Before making changes, identify the specific cause by reviewing the logs.

• On AwakeNode: Navigate to the File Manager in your panel, open the logs folder, and view the latest.log file. Look for lines marked [ERROR] or [FATAL] immediately preceding the IllegalStateException.
• On other hosts: Use your SFTP client to download the latest.log file from the logs directory to your computer and open it in a text editor.

2. Verify Plugins and Mods

Often, this error is caused by a plugin or mod that is incompatible with your current server version.

• On AwakeNode: Use the Plugin Installer or Mod Installer to temporarily remove recently added plugins or mods. Restart the server to see if it boots successfully.
• On other hosts: Manually move the contents of your plugins or mods folder to a backup location on your computer. Restart the server; if it starts, add the files back one by one to identify the culprit.

3. Reset Configuration Files

Corrupted configuration files (such as server.properties or plugin config files) can prevent startup.

• On AwakeNode: Use the File Manager to rename the problematic configuration file (e.g., rename server.properties to server.properties.old). The server will generate a fresh, default file upon the next start.
• On other hosts: Use your SFTP client to rename or delete the configuration files in the root directory. Restart your server to allow the software to regenerate default settings.

4. Check Java Version and RAM

If the error persists, it may be related to your environment settings.

• Java Version: Ensure your server is running the correct Java version for your Minecraft version (e.g., Java 17 for 1.18+, Java 21 for 1.20.5+). You can change this in your panel settings.
• RAM: If your server is crashing due to memory exhaustion, you may need to upgrade your plan. On AwakeNode, upgrading your plan automatically updates your Xmx settings. On other hosts, you must manually edit the -Xmx flag in your startup script. If you believe your startup flags are incorrect, please contact Support for assistance.