> For the complete documentation index, see [llms.txt](https://docs.blixaozric.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blixaozric.online/kit-harbor/license-activation.md).

# License Activation

{% hint style="info" %}
After purchasing KitHarbor, your license key is issued manually. Join our Discord server and open a ticket to receive your key.

**Discord:** <https://discord.gg/PhwdwdRMU8>
{% endhint %}

#### Activating your license

{% tabs %}
{% tab title="Paper / Folia" %}

1. Place KitHarbor into your server's `plugins` folder and start the server once so it generates its files, then stop the server.
2. Open `plugins/KitHarbor/config.yml`.
3. Find the `LICENSE` section and paste your key into `KEY`:

```yaml
   LICENSE:
     KEY: "XXXX-XXXX-XXXX-XXXX"
```

4. Save the file and start your server. KitHarbor will validate your key on startup.
   {% endtab %}
   {% endtabs %}

#### License status

On startup, KitHarbor prints a license banner to your console showing the result:

|   Status   |                                                             Meaning                                                             |
| :--------: | :-----------------------------------------------------------------------------------------------------------------------------: |
| `Verified` |                                       Your license is valid and KitHarbor is fully active.                                      |
|   `Grace`  |    The license server was briefly unreachable. KitHarbor keeps running on your last successful validation for a short period.   |
|  `Failed`  | The license is invalid, revoked, or in use on another server. Kit functionality is disabled until a valid license is confirmed. |

#### One license, one server

Each license locks to the first server that activates it. If the same key is used on a different server, that server will be rejected while your original server keeps working.

{% hint style="warning" %}
Moving to a new server or host? Your license is tied to your original machine. Open a ticket in our [Discord](https://discord.gg/PhwdwdRMU8) and we'll reset it so it can re-activate on your new server.
{% endhint %}

#### Troubleshooting

<details>

<summary>My console shows "Failed — locked to another machine"</summary>

Your key is already active on a different server. If you've changed hosts or your machine changed, open a ticket in our [Discord](https://discord.gg/PhwdwdRMU8) and we'll reset the lock so it can re-activate.

</details>

<details>

<summary>My console shows "Could not reach license server"</summary>

KitHarbor couldn't connect to the license server. It will keep working for a short grace period if it has recently validated. If the problem persists, check that your server has outbound internet access, then contact us on Discord.

</details>

<details>

<summary>My console shows "unknown key"</summary>

The key in your config wasn't recognized. Double-check you pasted it exactly as provided, with no extra spaces or quotes issues, then restart. If it still fails, contact us on Discord.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.blixaozric.online/kit-harbor/license-activation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
