> For the complete documentation index, see [llms.txt](https://wiki.halosdev.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.halosdev.com/halos-anti-xray/first-install.md).

# First Install

HalosAntiXray is delivered through **HalosLoader**, our loader plugin. The loader verifies your license, downloads the latest build automatically, and keeps it up to date. You never need to manually download and upload jars for updates.

### Step 1 - Put the Loader in your plugins folder

Drop **HalosLoader.jar** into the `plugins` folder on your Minecraft server.

### Step 2 - Start the server once

Start the server so the loader can generate its config file:

```
plugins/HalosLoader/config.yml
```

HalosAntiXray won't load yet. That's expected, you still need to enable it in the next steps.

### Step 3 - Get your license key

Join our [Discord server](https://discord.gg/halosdev) and open a support ticket to verify your purchase. Make sure you include **proof of purchase**. Our team will send you your **license key**.

### Step 4 - Enable HalosAntiXray in the loader config

Open `plugins/HalosLoader/config.yml` and find the HalosAntiXray entry under `plugins`. Set `enabled` to `true` and paste your license key:

```yaml
plugins:
- name: HalosAntiXray
  enabled: true
  license: XXXX-XXXX-XXXX
  version: STABLE
```

{% hint style="info" %}
Leave `version` on `STABLE`. Only switch to `DEV` or `PREV` if our team asks you to.
{% endhint %}

### Step 5 - Restart the server

Restart your server. The loader will verify your license and download HalosAntiXray. Once it loads, a `plugins/HalosAntiXray` folder will generate with the plugin's config files. From there you can set up HalosAntiXray however you like.

That's it, you're installed.

### Troubleshooting

**HalosAntiXray didn't load after restarting?** Check these in order:

1. `enabled` is set to `true` in `plugins/HalosLoader/config.yml`
2. Your license key is pasted correctly (no extra spaces, replaces the `XXXX-XXXX-XXXX` placeholder)
3. Your server has internet access, the loader needs it to verify your license and download the plugin
4. Check the server console for HalosLoader errors on startup

Still stuck? Open a ticket in our [Discord](https://discord.gg/halosdev) and send us your startup log.