---
title: Manage users and groups in User and password mode
product: Unity Version Control
canonical: https://docs.unity.com/en-us/unity-version-control/uvcs-on-prem/authentication/manage-up-users
last_updated: 2026-11-03
generated_at: 2026-11-04T15:48:52.302Z
locale: en-us
---

# Manage users and groups in User and password mode

> Manage users, groups, and passwords in User and password mode with the server administration console or the umtool command.

In User and password (UP) mode, you manage the users and groups of your Unity Version Control (UVCS) server yourself.

You can use the server administration console, or the `umtool` command on the command line. Both tools update the `users.conf` and `groups.conf` files.

For information about how UP mode works, refer to [User and password authentication](./user-password-auth.md).

## Manage users and groups in the server administration console

Use the **User and password** configuration section of the server administration console to:

* Create users and groups.
* Assign users to groups.
* Change user passwords.
* Rename or delete users and groups.

Each user sets their sign-in name and password in the [client configuration wizard](../client-configuration#configure-in-the-gui). If the credentials don't match, the desktop application displays a sign-in screen at startup. The user enters the correct credentials there.

## Manage users and groups on the command line

`umtool` is a server command that configures users, groups, their relationships, and passwords from the operating system's console.

To get help for a subcommand, run the following command. Replace `%serverinstalldir%` with the path to your server installation directory:

```shell
%serverinstalldir%/plasticd umtool help <command_name>
```

The following table lists the `umtool` subcommands:

|   **Subcommand name**  | **Abbreviation** |           **Description**          |
| :--------------------: | :--------------: | :--------------------------------: |
|    `addgrouptogroup`   |      `agtg`      |       Add a group to a group.      |
|    `addusertogroup`    |      `autg`      |       Add a user to a group.       |
|  `changeuserpassword`  |     `passwd`     |      Change a user's password.     |
|      `creategroup`     |       `cg`       |        Create a UVCS group.        |
|      `createuser`      |       `cu`       |         Create a UVCS user.        |
|         `help`         |       `hlp`      |    Show the help for a command.    |
|      `listgroups`      |       `lg`       |    List the current UVCS groups.   |
| `listmembersfromgroup` |      `lmfg`      |    List the members of a group.    |
|       `listusers`      |       `lu`       |    List the current UVCS users.    |
|      `removegroup`     |       `rmg`      |        Delete a UVCS group.        |
| `removegroupfromgroup` |      `rmgfg`     | Remove a group from another group. |
|      `removeuser`      |       `rmu`      |         Delete a UVCS user.        |
|  `removeuserfromgroup` |      `rmufg`     |     Remove a user from a group.    |
|      `renamegroup`     |       `rng`      |        Rename a UVCS group.        |
|      `renameuser`      |       `rnu`      |         Rename a UVCS user.        |

The following examples show common `umtool` commands:

|                 **Example**                |                              **Command**                             |
| :----------------------------------------: | :------------------------------------------------------------------: |
|         Create a user called maria         |             `%serverinstalldir%/plasticd umtool cu maria`            |
|      Create a group called developers      |          `%serverinstalldir%/plasticd umtool cg developers`          |
| Add a user (maria) to a group (developers) | `%serverinstalldir%/plasticd umtool addusertogroup maria developers` |

## Additional resources

* [User and password authentication](./user-password-auth.md)
* [CHANGEUSERPASSWORD](../../uvcs-cli/changeuserpassword)
* [Client configuration](../client-configuration)
* [Security scenarios](../../security-scenarios)
* [Manage On-Prem licenses](../on-prem-licenses)