Troubleshooting

​

Server will not start

The EULA prompt keeps appearing

Confirm the EULA from the Catalyst prompt. Catalyst writes eula=true to the server folder. If you edit manually, make sure the file is named eula.txt and is in the server root.

Java is missing or wrong

Check the server settings tab for the Java path. Clear an invalid custom path or assign a compatible Java executable. Catalyst can also download a managed runtime.

The console never reaches Online

Read the last console lines for port conflicts, plugin crashes, mod loader errors, or invalid server.properties values.

​

Analytics are empty

• Confirm the server is Paper or Purpur.
• Confirm CatalystAnalytics.jar exists in plugins/.
• Start the server long enough for the plugin to create plugins/CatalystAnalytics/data/analytics.json.
• Check the console for plugin startup errors.
• Use /analytics status as an operator.

​

Modrinth install failed

• Confirm the server platform supports the content type.
• Check that the selected Minecraft version and loader have compatible files.
• Restart the server after install or update.
• If a dependency failed, try installing the dependency directly from the content browser.

​

Backup or restore failed

• Restore only while the server is stopped.
• Make sure there is enough disk space for the zip and extracted server.
• Cancel a stuck backup from the backup progress UI, then retry.
• Keep backups outside the server folder too if the disk itself is unreliable.

​

ngrok tunnel failed

• Enable ngrok in Settings.
• Re-enter and validate the authtoken.
• Start the Minecraft server before starting the tunnel.
• Check whether another process is using the local server port.
• Confirm your ngrok account allows TCP tunnels.

​

Import failed

• Import archives must include manifest.json.
• The archive must stay within the configured size and entry limits.
• Archives with paths that escape the target folder are rejected.
• Export from Catalyst when possible instead of hand-building the zip.