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