Admin Area settings

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:

OptionDescription
Visibility and access controlsSet 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 limitsDiff content limits.
Sign-up restrictionsConfigure the way a user creates a new account.
Sign in restrictionsSet requirements for a user to sign-in. Enable mandatory two-factor authentication.
Terms of Service and Privacy PolicyInclude a Terms of Service agreement and Privacy Policy that all users must accept.
External AuthenticationExternal Classification Policy Authorization
Web terminalSet max session time for web terminal.
Web IDEManage Web IDE Features.

Integrations

OptionDescription
ElasticsearchElasticsearch integration. Elasticsearch AWS IAM.
PlantUMLAllow rendering of PlantUML diagrams in Asciidoc 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.
Third party offersControl the display of third party offers.
SnowplowConfigure the Snowplow integration.
Google GKEGoogle GKE integration allows you to provision GKE clusters from GitLab.
Amazon EKSAmazon EKS integration allows you to provision EKS clusters from GitLab.

Repository

OptionDescription
Repository mirrorConfigure repository mirroring.
Repository storageConfigure storage path settings.
Repository maintenance(Repository checks and Housekeeping). Configure automatic Git checks and housekeeping on repositories.
Repository static objectsServe repository static objects (for example, archives, blobs, …) from an external storage (for example, a CDN).

Templates

OptionDescription
TemplatesSet instance-wide template repository.
Custom project templatesSelect the custom project template source group.

CI/CD

OptionDescription
Continuous Integration and DeploymentAuto DevOps, runners and job artifacts.
Required pipeline configuration Set an instance-wide auto included pipeline configuration. This pipeline configuration will be run after the project’s own configuration.
Package Registry Settings related to the use and experience of using GitLab’s Package Registry.

Reporting

OptionDescription
Spam and Anti-bot ProtectionEnable reCAPTCHA or Akismet and set IP limits. For reCAPTCHA, we currently only support v2.
Abuse reportsSet notification email for abuse reports.

Metrics and profiling

OptionDescription
Metrics - InfluxEnable and configure InfluxDB metrics.
Metrics - PrometheusEnable and configure Prometheus metrics.
Metrics - GrafanaEnable and configure Grafana.
Profiling - Performance barEnable access to the Performance Bar for a given group.
Self monitoringEnable or disable instance self monitoring.
Usage statisticsEnable or disable version check and usage ping.
Pseudonymizer data collection Enable or disable the Pseudonymizer data collection.

Network

OptionDescription
Performance optimizationWrite to “authorized_keys” file and Push event activities limit and bulk push events. Various settings that affect GitLab performance.
User and IP rate limitsConfigure limits for web and API requests.
Outbound requestsAllow requests to the local network from hooks and services.
Protected PathsConfigure paths to be protected by Rack Attack.
Incident Management LimitsConfigure limits on the number of inbound alerts able to be sent to a project.

Geo

OptionDescription
GeoGeo allows you to replicate your GitLab instance to other geographical locations. Redirects to Admin Area > Geo > Settings, and will no longer be available at Admin Area > Settings > Geo in GitLab 13.0.

Preferences

OptionDescription
EmailVarious email settings.
Help pageHelp page text and support page url.
PagesSize and domain settings for static websites
Real-time featuresChange this value to influence how frequently the GitLab UI polls for updates.
Gitaly timeoutsConfigure Gitaly timeouts.
LocalizationDefault 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.