---
title: "Managing Project Users"
description: "Managing project membership"
date: 2021-08-02
lastmod: 2026-05-29
canonical: "https://container-registry.com/docs/user-manual/projects/managing-project-users/"
source: "https://container-registry.com/docs/user-manual/projects/managing-project-users/index.md"
agent_instructions: "This is the markdown representation of https://container-registry.com/docs/user-manual/projects/managing-project-users/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/user-manual/projects/managing-project-users/index.md>. Site index: <https://container-registry.com/llms.txt>.


# Managing Project Users

*Managing project membership*


Managing Project Users
=================================

The user that created a project and the super admin of the instance can add users to projects to enable them to perform different actions.\
It is possible to pull images from a public repository without being a project member. But a membership grants users other rights depending on the role they are assigned. 

# Project Member Permissions
Below is the overview of all project permissions by five types of roles:
|Action                                 |Limited Guest|Guest|Developer|Master|Project Admin|System Administrator|
|---------------------------------------|-------------|-----|---------|------|-------------|--------------------|
|See the project configurations         |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Edit the project configurations        |             |     |         |      |✓            |           ✓        |
|See a list of project members          |             |✓    |✓        |✓     |✓            |           ✓        |
|Create/edit/delete project members     |             |     |         |      |✓            |           ✓        |
|See a list of project logs             |             |✓    |✓        |✓     |✓            |           ✓        |
|See a list of project replications     |             |     |         |✓     |✓            |           ✓        |
|See a list of project replication jobs |             |     |         |      |✓            |           ✓        |
|See a list of project labels           |             |     |         |✓     |✓            |           ✓        |
|Create/edit/delete project labels      |             |     |         |✓     |✓            |           ✓        |
|See a list of repositories             |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Create repositories                    |             |     |✓        |✓     |✓            |           ✓        |
|Edit/delete repositories               |             |     |         |✓     |✓            |           ✓        |
|See a list of images                   |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Retag image                            |             |✓    |✓        |✓     |✓            |           ✓        |
|Pull image                             |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Push image                             |             |     |✓        |✓     |✓            |           ✓        |
|Scan/delete image                      |             |     |         |✓     |✓            |           ✓        |
|Add scanners to Harbor                 |             |     |         |      |             |           ✓        |
|Edit scanners in projects              |             |     |         |      |✓            |           ✓        |
|See a list of image vulnerabilities    |✓            |✓    |✓        |✓     |✓            |           ✓        |
|See image build history                |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Add/Remove labels of image             |             |     |✓        |✓     |✓            |           ✓        |
|See a list of helm charts              |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Download helm charts                   |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Upload helm charts                     |             |     |✓        |✓     |✓            |           ✓        |
|Delete helm charts                     |             |     |         |✓     |✓            |           ✓        |
|See a list of helm chart versions      |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Download helm chart versions           |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Upload helm chart versions             |             |     |✓        |✓     |✓            |           ✓        |
|Delete helm chart versions             |             |     |         |✓     |✓            |           ✓        |
|Add/Remove labels of helm chart version|             |     |✓        |✓     |✓            |           ✓        |
|See a list of project robots           |             |     |         |✓     |✓            |           ✓        |
|Create/edit/delete project robots      |             |     |         |      |✓            |           ✓        |
|See configured CVE whitelist           |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Create/edit/remove CVE whitelist       |             |     |         |      |✓            |           ✓        |
|Enable/disable webhooks                |             |     |✓        |✓     |✓            |           ✓        |
|Create/delete tag retention rules      |             |     |✓        |✓     |✓            |           ✓        |
|Enable/disable tag retention rules     |             |     |✓        |✓     |✓            |           ✓        |
|Create/delete tag immutability rules   |             |     |         |✓     |✓            |           ✓        |
|Enable/disable tag immutability rules  |             |     |         |✓     |✓            |           ✓        |
|See project quotas                     |✓            |✓    |✓        |✓     |✓            |           ✓        |
|Edit project quotas                    |             |     |         |      |             |           ✓        |

The matrix applies to the users that are registered in the instance. 

Unregistered **anonymous** users can access public projects in the read-only mode and pull any images from such projects and for both [types of projects](/docs/user-manual/projects/_index.md#types-of-projects). 

# Adding Project Members
By default, any new project has no users except the project admin that created it. Super admins can access projects that they are not members of.

To enable your collaborators to work on the project, you need to add them. There are two methods for doing this. An important **prerequisite** is that they must be users of the same instance. If they are not, refer to this article to [add users to the instance](/docs/administration-manual/user-management/index.md).

Regardless of the method you want to use for adding project members:
* Go to the *Projects* section in the navigation pane;
* Open the project in detailed view;
* Go to the **Members** tab.

![](../members_section.png)

## Adding Users One by One

If you want to add single users, use **+ User** button. Start typing in the name and a dropdown with a few suggestions will appear.
![](../type_in_user_name.png)

By default, every new user is granted the *project admin* role, thus, acquiring the same rights as the project creator has. Remember to change this, if you want to restrict the permissions level.

## Adding LDAP/AP User Groups

### Prerequisites

1. This method is available for instances using **LDAP/AD authentication**. Read about configuring this method of authentication [here](/docs/administration-manual/authentication/ldap-ad-authentication/index.md).

2. Another important **Prerequisite** is that you must enable the **memberof feature** on the LDAP/AD server. It is explained in the same guide mentioned above, as well as in [this external technical note](https://technicalnotes.wordpress.com/2014/04/19/openldap-setup-with-memberof-overlay/).

3. Eventually, you need to create user groups on your LADP/AD server since, with this authentication method, the super admins cannot manage users inside the Container Registry interface.

### Steps

* Click **+ Group** button;
* Select a user group:
    * If you use the group option for the first time, and do not have any user groups in your Container Registry yet, select **Add a group from LDAP to project member**.     
        * Enter the LDAP Group DN;
        * Optionally: give your group a catchy name.
    * If you already used some LDAP/AD groups, select **Add an existing user group to project members** and start typing the name of the group. 
* Assign a role to the new project group.

The corresponding permissions will be granted to all users in this group.

## Adding OIDC User Groups

### Prerequisites
1. This method is available for instances using OIDC as authentication method. Read about configuring this method of authentication [here](/docs/administration-manual/authentication/index.md).
<!--- REPLACE LINK LATER / YL-->
2. User groups must be created in the OIDC provider workspace.

### Steps 

* Click **+ Group** button;
* Type in *the correct name* of the group as it exists in the OIDC provider;
* Assign a project role to this group.

The corresponding permissions will be granted to all users in this group.

# Deleting Users

To delete one or a few users, click on the tickbox next to the user entry, then go to **Actions** and select **Remove**.
![](../delete_project_users.png)

# Changing Project Role

To change the project role for one or a few users, check the tickboxes next to their names, click **Actions**, and select a new role.

![](../change_project_role.png)


