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

# User Management

Last updated on Dec 26, 2023

Part of the Coordinator installation involves creating a Grid Admin user with a username and password to access the Coordinator Monitor. You need to log in every time you [access the Coordinator Manager](/windows/10.6/coord-access). If you are inactive in the user interface for more than 45 minutes, you need to log in again.

You can create and edit additional users. Each user is assigned a role the determines their level of permissions in the Coordinator Manager.

## User Roles

* **Grid Admin:** Has full permissions to view and edit all items in the Coordinator Manager. The first user created is automatically assigned the role of Grid Admin.

* **Group Manager**: Has permissions to edit the Agents in the Agent List, as well as view (but not edit) the Settings and License areas.

* **Viewer:** Has permissions to view the Agent List and License Details, but cannot edit anything in the Coordinator Manager.

## Create a New User

1. In the **User Management** area, click **Add User**.

   <img src="https://mintlify.s3.us-west-1.amazonaws.com/incredibuild-docs-live/images/windows/_shared/windows/ib_10_3/user%20management/2.png" alt="" />

2. Fill in the **Role** and **Password**, and any optional details that will help you manage your users and click **Add**.

   <img src="https://mintlify.s3.us-west-1.amazonaws.com/incredibuild-docs-live/images/windows/_shared/windows/ib_10_3/user%20management/3.png" alt="" />

You can also create new users with our [User Management API](/windows/10.6/api-users).

## Edit an Existing User

Grid Admin users can edit the details of any user by clicking the edit icon next to a single user and modifying the details.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/incredibuild-docs-live/images/windows/_shared/windows/ib_10_3/user%20management/12.png" alt="" />

Grid Admin users can also change a user's role directly in the User grid by using the Role dropdown.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/incredibuild-docs-live/images/windows/_shared/windows/ib_10_3/user%20management/4.png" alt="" />

Additionally, all users can view and edit their own user details and password. For details, see below.

## View and Edit your User Details and Password

All users who are logged into the Coordinator Monitor can view and edit their user details and password in **My Profile** > **Profile Settings**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/incredibuild-docs-live/images/windows/_shared/windows/ib_10_3/user%20management/8.png" alt="" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/incredibuild-docs-live/images/windows/_shared/windows/ib_10_3/user%20management/9.png" alt="" />

## Forgot Username or Password

### Non-Admin User

If a user who is not an admin forgot their username or password, the following procedure can be used by their admin to set a new password:

1. Go to the Coordinator Manager > User Management area.

2. Select a user and click **Change Password**.

   <img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/change_user_password.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=55d8a505b05075b57d3822ab07de2abb" alt="" width="1920" height="652" data-path="images/windows/_shared/windows/change_user_password.png" />

### Admin User

If your Grid Admin user is locked out, or you forgot your password, use the following command to create a new admin user. This must be done on the Coordinator machine in the command line as an administrator:

```
cd C:\Program Files (x86)\Incredibuild\Manager
manager.exe updateUser -u <original username> -p <new or old password> -t Active
```

If you forgot your Grid Admin username, you need to create a new Grid Admin user. Run the following command on the Coordinator machine in the command line as an administrator:

```
cd C:\Program Files (x86)\Incredibuild\Manager
manager.exe createUser -u <new user name> -p <new password>
```

## Locking and Unlocking Users

If a user attempts to log in a number of times with the incorrect credentials, they will be locked out and see a screen like this:

<img src="https://mintcdn.com/incredibuild-docs-live/9xHqsGp5LMBhv5lm/images/windows/_shared/windows/user_locked.png?fit=max&auto=format&n=9xHqsGp5LMBhv5lm&q=85&s=2479f3effd550c3b9fc1cce53b1635c8" alt="" width="1920" height="816" data-path="images/windows/_shared/windows/user_locked.png" />

Any admin user can unlock another user by clicking **Unlock** in the user details and **Save**.

<img src="https://mintcdn.com/incredibuild-docs-live/9xHqsGp5LMBhv5lm/images/windows/_shared/windows/unlock_user.png?fit=max&auto=format&n=9xHqsGp5LMBhv5lm&q=85&s=530ed7f10aa133a9740a96080e2cedd6" alt="" width="1920" height="886" data-path="images/windows/_shared/windows/unlock_user.png" />
