> ## Documentation Index
> Fetch the complete documentation index at: https://catalyst.leifiyo.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common fixes for startup, downloads, analytics, Modrinth, backups, ngrok, and imports.

## Server will not start

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="The console never reaches Online">
  Read the last console lines for port conflicts, plugin crashes, mod loader errors, or invalid `server.properties` values.
</Accordion>

## 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.

<Info>
  When in doubt, open the server folder from Catalyst and inspect `logs/latest.log` alongside the live console output.
</Info>