> ## 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.

# Assigning Agents to Build Groups During Installation

Last updated on Mar 08, 2023

For Enterprise Edition only

You can assign an Agent to a Build Group during its installation via:

* Silent installation

* Setup wizard

<Note>
  **Note:** The Build Group must already exist.
</Note>

## Enabling Assignment

In order to assign an Agent to a Build Group during installation, enable this option on the Coordinator.

**To enable the assignment:**

1. Go to **Coordinator > Coordinator Settings > Coordinator > API Access**and select **Allow Agents self registration to Build Group**.

   <img src="https://mintcdn.com/incredibuild-docs-live/pPg-q9k14FRu98o_/images/windows/_shared/windows/1456734215/1456570408.png?fit=max&auto=format&n=pPg-q9k14FRu98o_&q=85&s=2520c91196c76beb3e5f4d8c259b3203" alt="" width="732" height="531" data-path="images/windows/_shared/windows/1456734215/1456570408.png" />

2. Click**OK**.

## Assigning an Agent via the Silent Installer

Use the option:`/Agent:Group={Group name}`

If a`{Group name}`is not specified, or if a non-existent group name is provided, the Agent is assigned to the**Default**Build Group.

**To assign an Agent to a Build Group via the Automated Installer:**

* Use the command, adding the`{Group name}`value:

  ```
  IBSetupConsole.exe /Install /Components=Agent /Coordinator={COORDINATORNAME} /Agent:Group={Group name} [General Options] [Agent Options]
  ```

  For example:

  ```
  IBSetupConsole.exe /Install /Components=Agent /Coordinator=win10-1 /Agent:Group=QA
  ```

**To install both a Coordinator and an Agent:**

* Use the following command, adding the`{Group name}`value:

  ```
  IBSetupConsole.exe /Install /Components=Coordinator,Agent /Coordinator={COORDINATORNAME} /Agent:Group={Group name} [General Options] [Agent Options]
  ```

**To install an Agent with a Single-Use VM license:**

* Use the command, adding the`{Group name}`value:

  ```
  IBSetupConsole.exe /Install /Components=Agent,oneuse /Coordinator={COORDINATORNAME} /Agent:Group={Group name} [General Options] [Agent Options]
  ```

## Assigning an Agent via the Setup Wizard

**To assign an Agent to a Build Group via the Setup wizard:**

1. Double-click the Incredibuild Setup file to start the Agent installation.

2. Follow the Setup wizard instructions, and click**Next**until you reach the**Coordinator Selection**page.

3. Select**Connect Agent to existing Coordinator**, and in the**Network name**field, enter the Coordinator IP address or hostname.

   <img src="https://mintcdn.com/incredibuild-docs-live/pPg-q9k14FRu98o_/images/windows/_shared/windows/1456570415/1456635936.png?fit=max&auto=format&n=pPg-q9k14FRu98o_&q=85&s=fdf1934bcc3142c01c57d8eae19c7cd0" alt="" width="973" height="742" data-path="images/windows/_shared/windows/1456570415/1456635936.png" />

4. Click the**Advanced**arrow and then, from the**Assign this to Build Group**dropdown list, select the required Build Group.

   <img src="https://mintcdn.com/incredibuild-docs-live/pPg-q9k14FRu98o_/images/windows/_shared/windows/1456570415/1456504867.png?fit=max&auto=format&n=pPg-q9k14FRu98o_&q=85&s=b0b49b812d3c3ac2a540d160fcbac7ee" alt="" width="970" height="742" data-path="images/windows/_shared/windows/1456570415/1456504867.png" />

5. Click**Next**and continue to follow the wizard instructions until you complete the Agent installation

[https://docs.incredibuild.com/Default.htm](https://docs.incredibuild.com/Default.htm)

[https://docs.incredibuild.com/lin/latest/Default.htm](https://docs.incredibuild.com/lin/latest/Default.htm)

[https://docs.incredibuild.com/win/v9/Default.htm](https://docs.incredibuild.com/win/v9/Default.htm)

[https://docs.incredibuild.com/cloud/Default.htm](https://docs.incredibuild.com/cloud/Default.htm)

Windowshttps\://[www.incredibuild.com/](http://www.incredibuild.com/) 9.6.11