# License Getting Started

Source: https://userguide.qualytics.io/self-hosted/license/getting-started/

*Deployment availability: Self-hosted.*

License management is available for **self-hosted** deployments only. It allows users with the **Admin** role to monitor license expiration, generate license request codes, and apply signed licenses.

> **Info: Permissions**
>
> Only users with the **Admin** role can view and manage the license. See the [Permissions](https://userguide.qualytics.io/self-hosted/license/deep-dive/permissions/) page for the full matrix.

---

## Deployment Configuration and Licensing

Self-hosted deployment setup uses four separate values:

| Value | Source | Purpose |
| --- | --- | --- |
| Container registry token | Provided by Qualytics before installation | Allows the cluster to pull Qualytics container images. |
| Deployment identifier | Provided by Qualytics before installation | Identifies one deployment. Add it to the Helm values exactly as provided, do not encode it, and keep the same value for upgrades. Never reuse it for another deployment. |
| License request | Generated by an Admin from the running deployment | Captures the information Qualytics needs to issue an initial or renewed signed license. |
| Signed license | Returned by Qualytics after processing a license request | Activates or renews the deployment license when an Admin applies it in the platform. |

The deployment identifier is required Helm configuration, but it is not a license. For installation details, see [Self-Hosted Deployment](https://userguide.qualytics.io/deployments/self-hosted-deployment/).

> **Warning: Protect License Values**
>
> Arrange an approved secure transfer method with your Qualytics account team or [support team](mailto:support@qualytics.ai) before sharing a license request or receiving a signed license. Do not place these values in ordinary email.

---

## Deep Dive

Understand how licensing works, including expiration, grace period, warning indicators, and permissions.

- **How It Works**

  License expiration, grace period, warning indicators, and field descriptions.

  [How It Works](https://userguide.qualytics.io/self-hosted/license/deep-dive/how-it-works/)
- **Permissions**

  Roles required to view, generate, and update licenses.

  [Permissions](https://userguide.qualytics.io/self-hosted/license/deep-dive/permissions/)

---

## How-tos

Apply and renew signed licenses for your deployment.

- **Update License**

  Apply a new or renewed signed license to your deployment (Admin).

  [Update License](https://userguide.qualytics.io/self-hosted/license/how-tos/update-license/)
- **Generate License Request**

  Generate a request for an initial or renewed signed license (Admin).

  [Generate License Request](https://userguide.qualytics.io/self-hosted/license/how-tos/generate-license-request/)

---

## API & FAQ

- **API**

  Manage licenses programmatically, including checking expiration, generating requests, and applying keys.

  [API](https://userguide.qualytics.io/self-hosted/license/api/)
- **FAQ**

  Common questions about licensing, grace periods, initial setup, and renewal.

  [FAQ](https://userguide.qualytics.io/self-hosted/license/faq/)

*Last updated: July 27, 2026.*