Admin Area settings (FREE SELF)

As an administrator of a GitLab self-managed instance, you can manage the behavior of your deployment. To do so, select Admin Area > Settings.

The Admin Area is not accessible on, and settings can only be changed by the administrators. See the settings documentation for all current settings and limits on the instance.


To access the default page for Admin Area settings:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
Option Description
Visibility and access controls Set default and restrict visibility levels. Configure import sources and Git access protocol.
Account and limit Set projects and maximum size limits, session duration, user options, and check feature availability for namespace plan.
Diff limits Diff content limits.
Sign-up restrictions Configure the way a user creates a new account.
Sign in restrictions Set requirements for a user to sign in. Enable mandatory two-factor authentication.
Terms of Service and Privacy Policy Include a Terms of Service agreement and Privacy Policy that all users must accept.
External Authentication External Classification Policy Authorization
Web terminal Set max session time for web terminal.
Web IDE Manage Web IDE features.
FLoC Enable or disable Federated Learning of Cohorts (FLoC) tracking.


Option Description
Elasticsearch Elasticsearch integration. Elasticsearch AWS IAM.
Kroki Allow rendering of diagrams in AsciiDoc and Markdown documents using
Mailgun Enable your GitLab instance to receive invite email bounce events from Mailgun, if it is your email provider.
PlantUML Allow rendering of PlantUML diagrams in documents.
Slack application (FREE SAAS) Slack integration allows you to interact with GitLab via slash commands in a chat window. This option is only available on, though it may be available for self-managed instances in the future.
Third party offers Control the display of third party offers.
Snowplow Configure the Snowplow integration.
Google GKE Google GKE integration allows you to provision GKE clusters from GitLab.
Amazon EKS Amazon EKS integration allows you to provision EKS clusters from GitLab.


Option Description
Repository's custom initial branch name Set a custom branch name for new repositories created in your instance.
Repository mirror Configure repository mirroring.
Repository storage Configure storage path settings.
Repository maintenance (Repository checks and Housekeeping). Configure automatic Git checks and housekeeping on repositories.
Repository static objects Serve repository static objects (for example, archives and blobs) from an external storage (for example, a CDN).

Templates (PREMIUM SELF)

Option Description
Templates Set instance-wide template repository.
Custom project templates Select the custom project template source group.


Option Description
Continuous Integration and Deployment Auto DevOps, runners and job artifacts.
Required pipeline configuration (PREMIUM SELF) Set an instance-wide auto included pipeline configuration. This pipeline configuration is run after the project's own configuration.
Package Registry Settings related to the use and experience of using the GitLab Package Registry. Note there are risks involved in enabling some of these settings.


Option Description
Spam and Anti-bot Protection Enable reCAPTCHA or Akismet and set IP limits. For reCAPTCHA, we currently only support v2.
Abuse reports Set notification email for abuse reports.

Metrics and profiling

Option Description
Metrics - Prometheus Enable and configure Prometheus metrics.
Metrics - Grafana Enable and configure Grafana.
Profiling - Performance bar Enable access to the Performance Bar for non-administrator users in a given group.
Self monitoring Enable or disable instance self monitoring.
Usage statistics Enable or disable version check and Service Ping.
Pseudonymizer data collection (ULTIMATE) Enable or disable the Pseudonymizer data collection.


Option Description
Performance optimization Write to "authorized_keys" file and Push event activities limit and bulk push events. Various settings that affect GitLab performance.
User and IP rate limits Configure limits for web and API requests.
Package Registry Rate Limits Configure specific limits for Packages API requests that supersede the user and IP rate limits.
Git LFS Rate Limits Configure specific limits for Git LFS requests that supersede the user and IP rate limits.
Files API Rate Limits Configure specific limits for Files API requests that supersede the user and IP rate limits.
Deprecated API Rate Limits Configure specific limits for deprecated API requests that supersede the user and IP rate limits.
Outbound requests Allow requests to the local network from hooks and services.
Protected Paths Configure paths to be protected by Rack Attack.
Incident Management Limits Limit the number of inbound alerts that can be sent to a project.
Notes creation limit Set a rate limit on the note creation requests.


Option Description
Geo Geo allows you to replicate your GitLab instance to other geographical locations. Redirects to Admin Area > Geo > Settings are no longer available at Admin Area > Settings > Geo in GitLab 13.0.


Option Description
Email Various email settings.
What's new Configure What's new drawer and content.
Help page Help page text and support page URL.
Pages Size and domain settings for static websites
Polling interval multiplier Configure how frequently the GitLab UI polls for updates.
Gitaly timeouts Configure Gitaly timeouts.
Localization Default first day of the week and Time tracking.
Sidekiq Job Limits Limit the size of Sidekiq jobs stored in Redis.

Default first day of the week

You can change the Default first day of the week for the entire GitLab instance:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > Preferences.
  3. Scroll to the Localization section, and select your desired first day of the week.