```{title} Users
```

# Users

Users must first be added to the server and then added to a group to manage their permissions. User permissions can be set by
updating the group settings found [here.](groups.md#group-settings).

## Create User

- Select the **Users** from the navigation menu.
- Select **Add User** from the top right of the **Users** table.

```{figure} /images/users/create_user.jpg
:align: center
:width: 100%

**Creating a new user**
```

- Fill out Users information with User properties below.

## User Properties

```{eval-rst}
+-----------------------------------------+---------------------------------------------------------------------------+
| User Name                               | Username for login                                                        |
+-----------------------------------------+---------------------------------------------------------------------------+
| Password                                | Password for login                                                        |
+-----------------------------------------+---------------------------------------------------------------------------+
| First Name                              | User's first name                                                         |
+-----------------------------------------+---------------------------------------------------------------------------+
| Last Name                               | User's last name                                                          |
+-----------------------------------------+---------------------------------------------------------------------------+
| Realm                                   | SSO that the user belongs too (local, LDAP, SAML, OIDC)                   |
+-----------------------------------------+---------------------------------------------------------------------------+
| Notes                                   | Notes about user                                                          |
+-----------------------------------------+---------------------------------------------------------------------------+
| Locked                                  | Lock account                                                              |
+-----------------------------------------+---------------------------------------------------------------------------+
| Disabled                                | The account is disabled. The user cannot login or authenticate until      |
|                                         | re-enabled by an administrator.                                           |
+-----------------------------------------+---------------------------------------------------------------------------+
| Reset Two Factor Authentication Secret  | Reset the 2FA secret. The users will be required to re-initialize the     |
|                                         | 2FA upon next login.                                                      |
+-----------------------------------------+---------------------------------------------------------------------------+
| Organization                            | Organization Name                                                         |
+-----------------------------------------+---------------------------------------------------------------------------+
| Last Session                            | Last login time                                                           |
+-----------------------------------------+---------------------------------------------------------------------------+
| Phone                                   | Phone number                                                              |
+--------------+------------------------------------------------------------------------------------------------------+
```

## Add User to Group

- Select **Groups** from navigational menu.
- Select **View** from the three dot menu of the group you want to add the user.
- Select **Add User** from Users in Groups table.

```{figure} /images/users/add_user_group.jpg
:align: center
:width: 80%

**Users in Group**
```

- Select the user you wish to add from dropdown menu and click **Add**.

```{figure} /images/users/add_user.JPG
:align: center
:width: 80%

**Adding a user to a group**
```

## User Settings

Users have the ability to change settings by visiting their profile.

- Auto Launch Session.

  Automatically launch a session when the user logs in. Kasm Workspaces will use the configured **Default Workspace Image**.

- Chat Sound Effects.

  Enable Sound effects for chats during shared sessions.

- Default Workspace Image.

  The Default Kasm Image to use. This is the Image that is used for the **/go** URL, clicking the **Launch Now** menu
  item, and for **Auto Launch Session**. This item overrides the corresponding group setting if defined.

- Show Tips During Session.

  By default the user is shown a Tip that describes how to find and use the control panel. This tip can be suppressed by
  setting this item to false.

- Toggle Control Panel.

  Open and close the control panel within a Kasm session by pressing the *Ctrl* key twice.

- Theme.

  Select the Kasm Workspaces app theme, there is also an *auto* setting that will use the OS setting of the user's local computer.

```{figure} /images/users/user_settings.JPG
:align: center
:width: 100%

**User Settings**
```