Users and Groups

This section covers how to manage users, create groups (organizations), assign roles, and control access to repositories.

Users

Creating a User

If open registration is disabled, the administrator creates users manually:

1. Administration -> Users
2. Click “Add User”
3. Enter a username, email, password
4. Optionally: assign the administrator role

Editing

On the user page, the administrator can:

• Change the role (user / administrator)
• Block or unblock the account
• Reset the password
• Assign or remove a Pro seat (if a Pro license is activated)
• Log in as the user (impersonation) - for diagnostics

Deletion

Administration -> Users -> find the user -> “Delete”. The user’s repositories are not deleted automatically.

---

Groups

A group (organization) is a way to unite users and repositories. For example: backend-team, frontend, devops. Repositories within a group are accessible to all its members according to their role.

Creating a Group

1. Click ”+” in the top bar -> “Group”
2. Enter a name (Latin letters, digits, hyphens) and description
3. Click “Create”

Adding Members

1. Open the group -> “Members”
2. Click “Add Member”
3. Find the user by name or email
4. Select a role

Built-in Roles

Role	Permissions
Guest	View public repositories
Reporter	View all group repositories, create issues
Developer	Push to unprotected branches, create pull requests, manage issues
Maintainer	Merge pull requests, manage branch protection, repository settings
Owner	Full control: manage members, delete repositories, group settings

Custom Roles (Pro)

If the built-in roles are not enough - create custom ones with an arbitrary set of permissions.

1. Open the group -> “Settings” -> “Roles”
2. Click “Create Role”
3. Enter a name and select permissions
4. Assign the role to group members

---

Repositories in a Group

Repositories created within a group inherit the group members’ permissions. For example, if a user has the Developer role in the group - they can push to all repositories in that group (to unprotected branches).

Creating a Repository in a Group

1. Open the group
2. Click “New Repository”
3. The repository will appear with the path group/repository

Repository-Level Collaborators

In addition to group permissions, you can add individual users to a specific repository:

1. Open the repository -> “Settings” -> “Collaborators”
2. Click “Add”
3. Select the user and role

---

Storage Quotas (Pro)

Limiting disk space for users and groups. Useful to prevent a single user from filling the entire disk with large Docker images or LFS files.

Configuration

1. Administration -> Quotas
2. Set a global limit - the default for everyone
3. For individual users or groups - set an individual override (more or less than the global limit)