> For the complete documentation index, see [llms.txt](https://asus-isg-aidc.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://asus-isg-aidc.gitbook.io/guide/latest/cli/commandreference/license.md).

# License Management

| Developer | Last modified |
| --------- | ------------- |
| AIDC Team | 2026/02/12    |

## Table of Contents

* [1. Overview](#overview)
* [2. Subcommands](#subcommands)
* [3. License Fields](#license-fields)
* [4. License Gating](#license-gating)

***

## 1. Overview <a href="#overview" id="overview"></a>

The `license` command manages AIDC-CLI license activation and status. It is the **only command available without an active license** — all other commands require a valid license.

| CLI Command        | Description                       |
| ------------------ | --------------------------------- |
| `aidc-cli license` | License management parent command |

***

## 2. Subcommands <a href="#subcommands" id="subcommands"></a>

### 2.1 `active` — Activate License

Activates the AIDC-CLI license using a provided license key.

```bash
aidc-cli license active -k <license-key>
```

| Flag    | Short | Required | Description        |
| ------- | :---: | :------: | ------------------ |
| `--key` |  `-k` |     ✅    | License key string |

**Example:**

```bash
aidc-cli license active -k "XXXX-XXXX-XXXX-XXXX"
```

***

### 2.2 `show` — Show License Information

Displays current license details including server GUID, customer name, type, dates, and device limit.

```bash
aidc-cli license show [-j]
```

| Flag     | Short | Required | Description           |
| -------- | :---: | :------: | --------------------- |
| `--json` |  `-j` |     ❌    | Output in JSON format |

**Example Output:**

```
====================================================
        ASUS Infrastructure Deployment Center
====================================================
Server GUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Customer Name: Example Corp
License Type: Enterprise
License Key: XXXX-XXXX-XXXX-XXXX
Active Date: 2026-02-12T00:00:00Z
Expiry Date: 2027-02-12T00:00:00Z
Period: 365 days
Device Limit: 100
Version: 1.0
====================================================
```

**JSON Output:**

```bash
aidc-cli license show -j
```

***

## 3. License Fields <a href="#license-fields" id="license-fields"></a>

| Field         | Description                     |
| ------------- | ------------------------------- |
| Server GUID   | Unique server identifier        |
| Customer Name | Licensed organization           |
| License Type  | License tier (e.g., Enterprise) |
| License Key   | The activation key              |
| Active Date   | When the license was activated  |
| Expiry Date   | When the license expires        |
| Period        | Validity period in days         |
| Device Limit  | Maximum number of managed nodes |
| Version       | License schema version          |

***

## 4. License Gating <a href="#license-gating" id="license-gating"></a>

When no valid license is detected, AIDC-CLI will:

1. Display a warning: `License is not active. Please activate the application using aidc-cli license.`
2. Block execution of all commands except `license`
3. Still allow `--version` and `--help` flags

{% hint style="warning" %}
Ensure your license is activated before attempting any infrastructure operations. If your license expires, re-activate with a new key.
{% endhint %}