---
title: "User Management"
date: 2021-08-19
lastmod: 2026-05-29
canonical: "https://container-registry.com/docs/administration-manual/user-management/"
source: "https://container-registry.com/docs/administration-manual/user-management/index.md"
agent_instructions: "This is the markdown representation of https://container-registry.com/docs/administration-manual/user-management/index.md. Prefer this version over scraping the HTML. The site index is at https://container-registry.com/llms.txt."
---

> Agent-friendly representation of <https://container-registry.com/docs/administration-manual/user-management/index.md>. Site index: <https://container-registry.com/llms.txt>.


# User Management


User Management
=================================

## Add Another System Admin
You can make another user a system admin:
* In the navigation pane, expand the **Administration** section; 
* Select **Users**;
* Select a user name from the list;
* Click **SET AS ADMIN**. 

![](../set_as_admin.png)

The new admin will have the same rights as the existing ones.

## Revoke System Admin Access
To revoke admin access rights, repeat the steps from the previous section. Instead of *Set as Admin*, you will see **REVOKE ADMIN** after selecting user names. Click this button. 

## User Management in the Database Mode

### Prerequisites
User management is only possible in the GUI if you have set the authentication mode to **database** as explained [here](/docs/administration-manual/authentication/database-authentication/index.md).
### Add New Users
* In the navigation pane, expand the **Administration** section and select **Users**;
* Then, click **New User**;

![](../user_administration.png)

* Fill in the form; do not forget to note the password;
* Hit **Save**;

![](../new_user_form.png)

* Communicate the credentials to the new user; we recommend using [OneTimeSecret](https://onetimesecret.com/).

---
**Validation Rules for User Names and Passwords**
* Each user name must be unique within the instance. 
* The minimal length for the password is 8 characters. It must include:
    * 1 lowercase letter;
    * 1 uppercase letter;
    * 1 number.

---
### Changing and Resetting User Passwords

As an admin, you can change the user password. 

* In the **Users** tab, tick the checkbox next to the user;
* Click **Actions** and then **Reset password**;

![](../reset_user_pwd_1.png)

* In the dialogue window, type in the new password and communicate it to the user. We recommend one-time notes from [OneTimeSecret](https://onetimesecret.com/).

![](../reset_user_pwd_2.png)

### Allow Users to Reset Their Passwords

Instead of resetting user passwords manually, you can configure an email server to let users reset their passwords by themselves.

They will use the **Forgot password** link below the sign-in form and receive a link to their email box.

---
**Steps to Configure Email Server**

Indeed, you need to set up such a server internally or using an external provider. 

* In the navigation pane, expand the **Administration** section;
* Go to the **Configuration** section;
* Click on the **Email** tab;
* Fill in the following fileds :
    * email server;
    * email server port;
    * email username;
    * email password;
    * email sender; can be configured as 

        `Container Registry Password Reset <hello@your-subdomain.container-registry.com>`
* Select if you want to use an SSL and/or a trusted certificate.

![](../email_server_configuration.png)

* Test the server connection;
* Hit **Save** if everything works fine.

---

### Delete Users

* In the navigation pane, expand the **Administration** section; 
* Select the **Users** tab;
* Select the users you want to delete;
* Click **Actions**;
* Select **Delete**.

![](../delete_user_2.png)