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 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
To access the default page for Admin Area settings:
- On the top bar, select Menu > Admin.
- 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. |
Integrations
| Option | Description |
|---|---|
| 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 (FREE SAAS) | 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 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. |
CI/CD
| 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. |
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 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. |
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. |
| 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. |
| 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. |
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 |
|---|---|
| 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:
- On the top bar, select Menu > Admin.
- On the left sidebar, select Settings > Preferences.
- Scroll to the Localization section, and select your desired first day of the week.