Admin Area settings (CORE ONLY)

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 GitLab.com, and settings can only be changed by the GitLab.com administrators. See the GitLab.com settings documentation for all current settings and limits on the GitLab.com instance.

General

Access the default page for admin area settings by navigating to Admin Area > Settings > General:

Option Description
Visibility and access controls Set default and restrict visibility levels. Configure import sources and Git access protocol.
Account and limit (STARTER) 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.

Integrations

Option Description
Elasticsearch Elasticsearch integration. Elasticsearch AWS IAM.
Kroki Allow rendering of diagrams in AsciiDoc and Markdown documents using kroki.io.
PlantUML Allow rendering of PlantUML diagrams in AsciiDoc and Markdown documents.
Slack application (FREE ONLY) 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.
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.

Repository

Option Description
Repository's custom initial branch name Set a custom branch name rather than master for all the new repositories created within 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, blobs, ...) from an external storage (for example, a CDN).

Templates (PREMIUM ONLY)

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

CI/CD

Option Description
Continuous Integration and Deployment Auto DevOps, runners and job artifacts.
Required pipeline configuration (PREMIUM ONLY) 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.

Reporting

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 a given group.
Self monitoring Enable or disable instance self monitoring.
Usage statistics Enable or disable version check and usage ping.
Pseudonymizer data collection (ULTIMATE) Enable or disable the Pseudonymizer data collection.

Network

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.
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 Configure limits on the number of inbound alerts able to be sent to a project.

Geo

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.

Preferences

Option Description
Email Various email settings.
Help page Help page text and support page URL.
Pages Size and domain settings for static websites
Real-time features Change this value to influence how frequently the GitLab UI polls for updates.
Gitaly timeouts Configure Gitaly timeouts.
Localization Default first day of the week and Time tracking.

NOTE: You can change the Default first day of the week for the entire GitLab instance in the Localization section of Admin Area > Settings > Preferences.