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

# Requirements

> System, network, and account requirements for running Catalyst.

Catalyst manages local Minecraft server processes. The app can download server JARs, managed Java runtimes, Modrinth content, and ngrok binaries when those features are used.

## Desktop requirements

| Area             | Requirement                                                                                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Operating system | Windows is the primary packaged target. macOS and Linux build targets exist for development packaging.                                                          |
| Memory           | Enough RAM for the app, the operating system, and each server. Catalyst keeps at least about 1 GB free and caps server allocation at about 80% of total memory. |
| Disk             | Space for server folders, worlds, logs, backups, exports, Java runtimes, Modrinth files, and analytics data.                                                    |
| Network          | HTTPS access for server downloads, Modrinth, GitHub release checks, ngrok installation, and optional Java runtime downloads.                                    |

## Accounts and tokens

<Tabs>
  <Tab title="Required">
    No Catalyst account is required. Minecraft server usage still follows Mojang's EULA and the rules of the server software you choose.
  </Tab>

  <Tab title="Optional">
    * ngrok authtoken for public tunnels.
    * OpenAI-compatible API key for the AI assistant.
    * GitHub access only if you are developing, releasing, or checking upstream releases manually.
  </Tab>
</Tabs>

## Java requirements

Catalyst detects installed Java runtimes and can download managed Adoptium runtimes when needed. The required major version depends on the Minecraft version:

| Minecraft version     | Java    |
| --------------------- | ------- |
| 1.20.5 and newer      | Java 21 |
| 1.17 through 1.20.4   | Java 17 |
| 1.12 through 1.16.5   | Java 11 |
| 1.7.10 through 1.11.2 | Java 8  |

<Info>
  A custom Java executable can be assigned per server from the server settings tab. Restart the server after changing it.
</Info>