> For the complete documentation index, see [llms.txt](https://docs.hex-rays.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses.md).

# Manage Your Account and Licenses

For paid IDA editions, everything starts with your My Hex-Rays account. You sign in to My Hex-Rays to buy licenses, get the installer and your license file, and manage your licenses and invoices later. Many of these tasks you can also do from the terminal with HCLI.

* [**My Hex-Rays**](https://my.hex-rays.com/): the web portal, for use in your browser.
* [**HCLI**](https://hcli.docs.hex-rays.com/): the command-line tool, for terminal use, scripts, automation and headless environments.

## My Hex-Rays: the web portal

My Hex-Rays is a one-stop shop where you can buy and manage your licenses, renew or upgrade your plan, download IDA, view your quotes and invoices, and create API keys. Use it if you prefer a web interface, or for tasks that are only available there, such as buying, activating or renewing licenses.

* **Shop**: buy new licenses and add-ons, or upgrade and renew your plan. See [Change your plan](https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses/plans-and-renewals.md#change-your-plan) and [Renew your plan](https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses/plans-and-renewals.md#renew-your-plan).
* **Manage IDA licenses**: activate your licenses, download your `.hexlic` license files, and give your teammates access to manage licenses. See [License Activation](https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses/licensing.md#license-activation) and [Grant access to manage licenses](#grant-access-to-manage-licenses).
* **Manage server licenses**: some add-ons include a license for a server, such as the License Server or Private Lumina. Add your servers and manage their licenses in My Hex-Rays. See [Server licenses](https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses/licensing.md#server-licenses).
* **Quotes and invoices**: view your quotes, payments and invoices.
* **Downloads**: download new IDA releases, the SDK and other tools.
* **API keys**: create and view API keys, for example to use HCLI.

### Grant access to manage licenses

You can invite your teammates to view and activate licenses via their own My Hex-Rays account. To grant access:

1. Select the license(s) you want to share and click **Grant Access**.
2. Add the email address of your teammate and click **Confirm**.
3. Your team member will receive an email invitation to log in to the portal and access the shared licenses.

![Grant access](https://492083732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFP6ibt8r6WPBHTqekG9u%2Fuploads%2Fgit-blob-bb9ac2cec3efe4b0d5f7e646f40bfdc982befd9f%2Fgrant-access.png?alt=media)

The [License Details](https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses/licensing.md#license-details) view allows you to review who currently has access to the license, remove users, or grant access to new ones.

## HCLI: the command-line tool

HCLI is a command-line interface for managing IDA licenses, installations and plugins. It's designed for both interactive use and automation. Use it to:

* install IDA unattended, for example in CI/CD pipelines or Docker containers
* download installers and `.hexlic` license files from a script
* manage plugins, and set up and manage IDAPython's virtual environment
* share files securely with Hex-Rays support

To install HCLI on macOS or Linux, run:

`curl -LsSf https://hcli.docs.hex-rays.com/install | sh`

For Windows and other options, see [Installation](https://hcli.docs.hex-rays.com/getting-started/installation/).

To sign in, run `hcli login`, which opens your browser so you can sign in to My Hex-Rays. In automated environments, use an API key instead, for example through the `HCLI_API_KEY` environment variable. See [Authentication](https://hcli.docs.hex-rays.com/getting-started/authentication/).

{% hint style="info" %}
HCLI downloads license files only for active licenses. Activate your licenses in [My Hex-Rays](https://my.hex-rays.com/) first.
{% endhint %}

## What you can do where

| Task                                               | My Hex-Rays |           HCLI           |
| -------------------------------------------------- | :---------: | :----------------------: |
| Buy, upgrade or renew a plan                       |      ✓      |                          |
| Activate licenses                                  |      ✓      |                          |
| Add and manage license servers                     |      ✓      |                          |
| Grant teammates access to manage licenses          |      ✓      |                          |
| View quotes and invoices                           |      ✓      |                          |
| List your licenses                                 |      ✓      |   ✓ `hcli license list`  |
| Download `.hexlic` license files                   |      ✓      |   ✓ `hcli license get`   |
| Download IDA installers                            |      ✓      |     ✓ `hcli download`    |
| Create API keys                                    |      ✓      | ✓ `hcli auth key create` |
| Install IDA unattended, with the license file      |             |   ✓ `hcli ida install`   |
| Copy a license file into an IDA directory          |             | ✓ `hcli license install` |
| Manage plugins and IDAPython's virtual environment |             |             ✓            |
| Share files with Hex-Rays support                  |             |      ✓ `hcli share`      |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hex-rays.com/getting-started/manage-your-account-and-licenses.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
