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

# User Management

Last updated on Nov 05, 2024

You need to log in every time you [access the Coordinator Manager](/linux/4.15.0/coord-access). A default user is created during installation with the username **ibadmin** and the password **ChangePass**. We recommend changing this as soon as you log in for the first time.

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

When a user is inactive in the user interface for more than 45 minutes, they need to log in again.

## 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, but cannot edit anything in the Coordinator Manager.

## Create a New User

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_management_add1.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=24a9dbe4d329c1060a0e1ab94aa2a359" alt="" width="1912" height="418" data-path="images/linux/4.15.0/linux/linux_4/user_management_add1.jpg" />

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_management_add2.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=e0d630ed43c2ddf76bbebb78a2e03da3" alt="" width="1843" height="745" data-path="images/linux/4.15.0/linux/linux_4/user_management_add2.jpg" />

## 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://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_management_edit1.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=c7a392b7ae5b18dff672311564a84273" alt="" width="1906" height="362" data-path="images/linux/4.15.0/linux/linux_4/user_management_edit1.jpg" />

<img src="https://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_management_edit2.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=c3d1ddffb292aad201771d2925aba095" alt="" width="1906" height="768" data-path="images/linux/4.15.0/linux/linux_4/user_management_edit2.jpg" />

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

<img src="https://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_management_edit3.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=971ff4434bad4c2313e649ccad2b979e" alt="" width="1887" height="405" data-path="images/linux/4.15.0/linux/linux_4/user_management_edit3.jpg" />

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://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_view_profile1.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=89284c3eda8774bc1687e6293b9232b7" alt="" width="529" height="928" data-path="images/linux/4.15.0/linux/linux_4/user_view_profile1.jpg" />

<img src="https://mintcdn.com/incredibuild-docs-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_view_profile2.jpg?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=d21cdbbecd64f7657ea95d96213422d1" alt="" width="1906" height="911" data-path="images/linux/4.15.0/linux/linux_4/user_view_profile2.jpg" />

## 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-migrated/E7jkz26VpcMP8xPn/images/linux/4.15.0/linux/change_user_password.png?fit=max&auto=format&n=E7jkz26VpcMP8xPn&q=85&s=256fb2f4807d5dc67ce0241f9eca937e" alt="" width="1920" height="652" data-path="images/linux/4.15.0/linux/change_user_password.png" />

### Admin User

If your Grid Admin user is locked out, or you forgot your password, use the following command. The -p flag will update the password to the input value. The -t Active flag will activate your user if it is locked. This must be done on the Coordinator machine in the command line:

```
cd /opt/incredibuild_management/ib_manager/sudo ./manager updateUser -u <original username> -p <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:

```
cd /opt/incredibuild_management/ib_manager/sudo ./manager 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-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/user_locked.png?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=34e1effa89bbf013a9e02ac3fe5c3533" alt="" width="1920" height="816" data-path="images/linux/4.15.0/linux/linux_4/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-migrated/Yn_ZbIXBhgOCDbkO/images/linux/4.15.0/linux/linux_4/unlock_user.png?fit=max&auto=format&n=Yn_ZbIXBhgOCDbkO&q=85&s=6c1253c55908ba1656e75669d87d27a7" alt="" width="1920" height="886" data-path="images/linux/4.15.0/linux/linux_4/unlock_user.png" />
