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

# First start

## First start

The first time you launch Qomicex, the **setup wizard** opens and takes a few minutes to configure the basics.

## Two modes

| Mode | Best for | What it covers |
| :- | :- | :- |
| **Quick setup** | Most users | Language, theme, Java, memory — the launcher recommends values, so you only confirm a few |
| **Custom setup** | Users who want full control | Everything above, plus download source, data directory and game directory |

## Wizard steps

* **Language** — Choose the interface language. It applies immediately and can be changed in settings at any time
* **Theme** — Dark / light, switchable in settings at any time
* **Directories** (custom mode only) — The data directory holds launcher configuration; the game directory (`.minecraft`) holds game files
* **Download source** (custom mode only) — Each source is speed-tested automatically and the lowest-latency one is selected; you can also tick "Auto-select the best"
* **Java runtime** — The launcher needs **four core runtimes: Java 8 / 17 / 21 / 25**. It deep-scans your machine automatically; missing versions can be downloaded online with one click
* **Memory** — **Automatic allocation** is recommended (calculated from available system memory); you can also set the maximum memory manually
* **Finish** — Review the configuration summary and start using the launcher

You can skip Java setup in the wizard, but **some game versions may not start** if your Java environment is incomplete. You can add them later in Settings → Java runtime.

No need to download anything again. On the home page, go to the instances page, click **Import** and select your existing `.minecraft` directory to take over existing versions. See [Install a game → Migrate an existing game](https://docs.qomicex.top/en/guide/installing-games.md#migrate-an-existing-game).

## Common startup issues

See [FAQ](https://docs.qomicex.top/en/guide/faq.md); if a problem remains unsolved, submit it via [Report an issue](https://docs.qomicex.top/en/guide/report-issue.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.