• Access the Admin Area
  • General
  • CI/CD
• Security and Compliance settings
  • Geo
  • Integrations
  • Metrics and profiling
  • Network
  • Preferences
  • Reporting
  • Repository
  • Templates
• Default first day of the week
• Default language

Admin Area settings

As an administrator of a GitLab self-managed instance, you can manage the behavior of your deployment.

The Admin Area is not accessible on GitLab.com, and settings can only be changed by the GitLab.com administrators. For the settings and limits on the GitLab.com instance, read GitLab.com settings.

Access the Admin Area

To access the Admin Area:

1. Sign in to your GitLab instance as an administrator.
2. On the top bar, select Main menu > Admin.
3. On the left sidebar, select Settings, and the group of settings to view:
   • General
   • Geo
   • CI/CD
   • Integrations
   • Metrics and profiling
   • Network
   • Preferences
   • Reporting
   • Repository
   • Templates

General

The General settings contain:

• 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.
• FLoC - Enable or disable Federated Learning of Cohorts (FLoC) tracking.

CI/CD

The CI/CD settings contain:

• Continuous Integration and Deployment - Auto DevOps, runners and job artifacts.
• Required pipeline configuration - 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. Some risks are involved in enabling some of these settings.

Security and Compliance settings

• License compliance settings: Enable or disable synchronization of package metadata by a registry type.

Geo

The Geo setting contains:

• Geo - 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.

Integrations

The Integrations settings contain:

• Elasticsearch - Elasticsearch integration. Elasticsearch AWS IAM.
• Kroki - Allow rendering of diagrams in AsciiDoc and Markdown documents using kroki.io.
• 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 - Slack integration allows you to interact with GitLab via slash commands in a chat window. This option is only available on GitLab.com, though it may be available for self-managed instances in the future.
• Customer experience improvement and third-party offers - Control the display of customer experience improvement content and third-party offers.
• Snowplow - Configure the Snowplow integration.
• Google GKE - Google GKE integration enables you to provision GKE clusters from GitLab.
• Amazon EKS - Amazon EKS integration enables you to provision EKS clusters from GitLab.

Metrics and profiling

The Metrics and profiling settings contain:

• 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.

Network

The Network settings contain:

• Performance optimization - Various settings that affect GitLab performance, including:
  • Write to authorized_keys file.
  • Push event activities limit and bulk push events.
• User and IP rate limits - Configure limits for web and API requests. These rate limits can be overridden:
  • 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.
  • Search rate limits - Configure global search request rate limits for authenticated and unauthenticated users.
  • 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 webhooks and integrations, or deny all outbound requests.
• 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.
• Get single user limit - Set a rate limit on users API endpoint to get a user by ID.
• Projects API rate limits for unauthenticated requests - Set a rate limit on Projects list API endpoint for unauthenticated requests.

Preferences

The Preferences settings contain:

• 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.
  • Time tracking.
• Sidekiq Job Limits - Limit the size of Sidekiq jobs stored in Redis.

Reporting

The Reporting settings contain:

• Spam and Anti-bot Protection - Enable anti-spam services, like reCAPTCHA, Akismet, or Spamcheck, and set IP limits.
• Abuse reports - Set notification email for abuse reports.
• Git abuse rate limit - Configure Git abuse rate limit settings.

Repository

The Repository settings contain:

• Repository’s custom initial branch name - Set a custom branch name for new repositories created in your instance.
• Repository’s initial default branch protection - Configure the branch protections to apply to every repository’s default branch.
• Repository mirror - Configure repository mirroring.
• Repository storage - Configure storage path settings.
• Repository maintenance:
  • Repository checks - Configure automatic Git checks on repositories.
  • Housekeeping. Configure automatic Git housekeeping on repositories.
  • Inactive project deletion. Configure inactive project deletion.
• Repository static objects - Serve repository static objects (for example, archives and blobs) from an external storage (for example, a CDN).

Templates

The Templates settings contain:

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

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 Main 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.

Default language

You can change the Default language for the entire GitLab instance:

1. On the top bar, select Main menu > Admin.
2. On the left sidebar, select Settings > Preferences.
3. Scroll to the Localization section, and select your desired default language.