> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging.incredibuild.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Licenses

Last updated on Oct 24, 2023

Your license is validated by communicating with our license server every 8 hours. If your Coordinator machine fails to connect to the license server for 7 days, your license will be locked until the connection is re-established. If your license is locked, you can only perform local builds with limited features.

## Viewing your License Details

You can view your license package details in the **Coordinator > License** area.

<img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/license_details2.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=34b5ba7642af13a2433f691f87e036c6" alt="" width="1440" height="900" data-path="images/windows/_shared/windows/license_details2.png" />

You can view a summary of your current license usage in the **Coordinator > Agent List** status bar.

<img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/license_usage2.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=7ba27a64eee64dd5a82cc285bb6468cc" alt="" width="2188" height="360" data-path="images/windows/_shared/windows/license_usage2.png" />

You can see the number of licenses that are currently assigned to agents, the number of available licenses, and whether any licenses are in the 24 hour cooldown period during which they cannot be moved to another Agent.

You can also see information about your Cloud Hours and Cache Cores.

## Assigning Licenses to Agents

By default, each newly added agent receives a helper license. This behavior can be adjusted in the [Coordinator Settings](/windows/10.8/coordinator-settings) > Agents area.

You can manually change the license of an individual agent, or a group of agents by going to the **menu** > **License Configuration**:

<img src="https://mintcdn.com/incredibuild-docs-live/p1PDJsQjAbPwdXdK/images/windows/10.3/windows/license_assign_basic.png?fit=max&auto=format&n=p1PDJsQjAbPwdXdK&q=85&s=0c745d44edbaa0453cb7610eb95bcd08" alt="" width="1864" height="916" data-path="images/windows/10.3/windows/license_assign_basic.png" />

When defining the **max cores** that each Helper can use, this settings can conflict with the similar settings in the [Agent Settings > Agent > CPU Utilization](/windows/10.8/agent-options) area on each Agent machine. The setting in Coordinator Manager is primarily used by the grid manager to manage licenses. The Agent setting allows owners of Helper machines to limit their use. The lower value of the two settings will determine the maximum number of cores a particular Agent can use.

To assign more than one Agent at once, select the Agents and use the Actions menu:

<img src="https://mintcdn.com/incredibuild-docs-live/p1PDJsQjAbPwdXdK/images/windows/10.3/windows/gifs/bulk_agent_select2.gif?s=e611a20923b6f8bdb25075e506f8c15c" alt="" width="1446" height="826" data-path="images/windows/10.3/windows/gifs/bulk_agent_select2.gif" />

## General License Settings

In the **Coordinator** > **Settings**> **Agent** area, you can manage all of the general license settings such as the timeout for offline licenses and the maximum number of helper cores per machine. For details, see [Coordinator Settings](/windows/10.8/coordinator-settings).

<img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/coordinator_settings_license.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=0b085622a191244971ef97f1da134397" alt="" width="1515" height="880" data-path="images/windows/_shared/windows/coordinator_settings_license.png" />

## Refreshing Your License

If there was a change in your license, it can take a few hours for this to be automatically reflected in the Coordinator. You can instantly update it on your own at any time if you want to speed this process up.

In the **Coordinator** > **License** tab, click **Update License Now**.
