GitLab Admin Area

The Admin Area provides a web UI to manage and configure some features of GitLab self-managed instances. If you are an administrator, you can access the Admin Area by visiting /admin on your self-managed instance. You can also access it through the UI:

  • GitLab versions 14.0 and later: on the top bar, select Menu > Admin.
  • GitLab versions 13.12 and earlier: on the top bar, select the Admin Area icon ( ).
note
Only administrators can access the Admin Area.

Admin Area sections

The Admin Area is made up of the following sections:

Section Description
Overview View your GitLab Dashboard, and administer projects, users, groups, topics, jobs, runners, and Gitaly servers.
Monitoring View GitLab system information, and information on background jobs, logs, health checks, and audit events.
Messages Send and manage broadcast messages for your users.
System Hooks Configure system hooks for many events.
Applications Create system OAuth applications for integrations with other services.
Abuse Reports Manage abuse reports submitted by your users.
License Add, display, and remove licenses.
Kubernetes Create and manage instance-level Kubernetes clusters.
Push rules Configure pre-defined Git push rules for projects. Also, configure merge requests approvers rules.
Geo Configure and maintain Geo nodes.
Deploy keys Create instance-wide SSH deploy keys.
Credentials View credentials that can be used to access your instance.
Integrations Manage instance-level default settings for a project integration.
Labels Create and maintain labels for your GitLab instance.
Appearance Customize GitLab appearance.
Settings Modify the settings for your GitLab instance.

Admin Area dashboard

The Dashboard provides statistics and system information about the GitLab instance.

To access the Dashboard, either:

  • On the top bar, select Menu > Admin.
  • Visit /admin on your self-managed instance.

The Dashboard is the default view of the Admin Area, and is made up of the following sections:

Section Description
Projects The total number of projects, up to 10 of the latest projects, and the option of creating a new project.
Users The total number of users, up to 10 of the latest users, the option of creating a new user, and a link to Users statistics.
Groups The total number of groups, up to 10 of the latest groups, and the option of creating a new group.
Statistics Totals of all elements of the GitLab instance.
Features All features available on the GitLab instance. Enabled features are marked with a green circle icon, and disabled features are marked with a power icon.
Components The major components of GitLab and the version number of each. A link to the Gitaly Servers is also included.

Overview section

The following topics document the Overview section of the Admin Area.

Administering Projects

You can administer all projects in the GitLab instance from the Admin Area’s Projects page.

To access the Projects page:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Projects.
  3. Select the All, Private, Internal, or Public tab to list only projects of that criteria.

By default, all projects are listed, in reverse order of when they were last updated. For each project, the following information is listed:

  • Name
  • Namespace
  • Description
  • Size, updated every 15 minutes at most

Projects can be edited or deleted.

The list of projects can be sorted by:

  • Updated date
  • Last created
  • Name
  • Most stars
  • Oldest created
  • Oldest updated
  • Largest repository

A user can choose to hide or show archived projects in the list.

In the Filter by name field, type the project name you want to find, and GitLab filters them as you type.

To filter only projects in that namespace, select from the Namespace dropdown list.

You can combine the filter options. For example, to list only public projects with score in their name:

  1. Select the Public tab.
  2. Enter score in the Filter by name… input box.

Administering Users

You can administer all users in the GitLab instance from the Admin Area’s Users page:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Users.

To list users matching a specific criteria, select one of the following tabs on the Users page:

For each user, the following are listed:

  1. Username
  2. Email address
  3. Project membership count
  4. Group membership count (introduced in GitLab 13.12)
  5. Date of account creation
  6. Date of last activity

To edit a user, select the Edit button in that user’s row. To delete the user, or delete the user and their contributions, select the cog dropdown in that user’s row, and select the desired option.

To change the sort order:

  1. Select the sort dropdown.
  2. Select the desired order.

By default the sort dropdown shows Name.

To search for users, enter your criteria in the search field. The user search is case insensitive, and applies partial matching to name and username. To search for an email address, you must provide the complete email address.

User impersonation

An administrator can “impersonate” any other user, including other administrators. This allows the administrator to “see what the user sees,” and take actions on behalf of the user. You can impersonate a user in the following ways:

  • Through the UI:
    1. On the top bar, select Menu > Admin.
    2. On the left sidebar, select Overview > Users.
    3. From the list of users, select a user.
    4. Select Impersonate.
  • With the API, using impersonation tokens.

All impersonation activities are captured with audit events.

By default, impersonation is enabled. GitLab can be configured to disable impersonation.

user impersonation button

User Permission Export

Version history

An administrator can export user permissions for all users in the GitLab instance from the Admin Area’s Users page. The export lists direct membership the users have in groups and projects.

The following data is included in the export:

Only the first 100,000 user accounts are exported.

user permission export button

Users statistics

The Users statistics page provides an overview of user accounts by role. These statistics are calculated daily, so user changes made since the last update are not reflected.

The following totals are also included:

  • Billable users
  • Blocked users
  • Total users

GitLab billing is based on the number of Billable users.

Add email to user

You must be an administrator to manually add emails to users:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Users (/admin/users).
  3. Locate the user and select them.
  4. Select Edit.
  5. In Email, enter the new email address. This adds the new email address to the user and sets the previous email address to be a secondary.
  6. Select Save changes.

User cohorts

The Cohorts tab displays the monthly cohorts of new users and their activities over time.

Prevent a user from creating groups

By default, users can create groups. To prevent a user from creating groups:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Users (/admin/users).
  3. Locate the user and select them.
  4. Select Edit.
  5. Clear the Can create group checkbox.
  6. Select Save changes.

Administering Groups

You can administer all groups in the GitLab instance from the Admin Area’s Groups page.

To access the Groups page:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Groups.

For each group, the page displays their name, description, size, number of projects in the group, number of members, and whether the group is private, internal, or public. To edit a group, select the Edit button in that group’s row. To delete the group, select the Delete button in that group’s row.

To change the sort order, select the sort dropdown and select the desired order. The default sort order is by Last created.

To search for groups by name, enter your criteria in the search field. The group search is case insensitive, and applies partial matching.

To Create a new group select New group.

Administering Topics

Introduced in GitLab 14.4.

You can administer all topics in the GitLab instance from the Admin Area’s Topics page.

To access the Topics page:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Topics.

For each topic, the page displays its name and the number of projects labeled with the topic.

To create a new topic, select New topic.

To edit a topic, select Edit in that topic’s row.

To remove a topic, select Remove in that topic’s row.

To search for topics by name, enter your criteria in the search box. The topic search is case insensitive and applies partial matching.

note
The assigned topics are visible only to everyone with access to the project, but everyone can see which topics exist at all on the GitLab instance.