# GitLab Documentation Learn how to use and administer GitLab, the most scalable Git-based integrated platform for software development. This file is automatically generated from data/en-us/navigation.yaml. Do not edit this file manually. To view GitLab documentation translated to Japanese, go to the [Japanese GitLab Docs site](https://docs.gitlab.com/ja-jp/). Navigation for the Japanese docs site is located at data/ja-jp/navigation.yaml. ## Use GitLab [Use GitLab](https://docs.gitlab.com/user): Get to know the GitLab end-to-end workflow. ### Getting started [Getting started](https://docs.gitlab.com/user/get_started) ### Tutorials [Tutorials](https://docs.gitlab.com/tutorials): Help learn key GitLab workflows by following guided instructions. [Find your way around](https://docs.gitlab.com/tutorials/gitlab_navigation): Introduction to the product. [Tutorial: Navigate the GitLab interface](https://docs.gitlab.com/tutorials/left_sidebar) [Tutorial: Use the personal homepage](https://docs.gitlab.com/tutorials/personal_homepage) [The DevSecOps Platform](https://docs.gitlab.com/devsecops): Learn how to use and administer GitLab, the most scalable Git-based fully integrated platform for software development. ### Manage your organization [Manage your organization](https://docs.gitlab.com/topics/set_up_organization): Users, groups, namespaces, SSH keys. [Tutorial: Set up your organization](https://docs.gitlab.com/tutorials/manage_user): Setup, configuration, onboarding, and organization structure. [Namespaces](https://docs.gitlab.com/user/namespace): Learn more about different types of namespaces. [Members](https://docs.gitlab.com/user/project/members): User management, roles, permissions, and access levels. [Organizations](https://docs.gitlab.com/user/organization): Namespace hierarchy. [Groups](https://docs.gitlab.com/user/group): Project management, access control, client groups, and team groups. [Import and migrate to GitLab](https://docs.gitlab.com/user/import): Repository migration, third-party repositories, and user contribution mapping. [Sharing projects and groups](https://docs.gitlab.com/user/project/members/sharing_projects_groups): Invitations, group inheritance, and project visibility. [User account options](https://docs.gitlab.com/user/profile): Profile settings, preferences, authentication, and notifications. [GitLab.com settings](https://docs.gitlab.com/user/gitlab_com): Configuration for the GitLab.com instance. [Logs on GitLab.com](https://docs.gitlab.com/user/gitlab_com/logging): How GitLab.com creates logs and how to erase job logs. ### Organize work with projects [Organize work with projects](https://docs.gitlab.com/user/project/organize_work_with_projects): Project visibility, search, badges, layout. [Getting started](https://docs.gitlab.com/user/get_started/get_started_projects): Configure projects to suit your organization. [Create a project](https://docs.gitlab.com/user/project): New project and project templates. [Manage projects](https://docs.gitlab.com/user/project/working_with_projects): Settings, configuration, project activity, and project deletion. [Project visibility](https://docs.gitlab.com/user/public_access): Public, private, and internal. [Project settings](https://docs.gitlab.com/user/project/settings) [Description templates](https://docs.gitlab.com/user/project/description_templates): Issue templates, merge request templates, instance, and group templates. [Deploy keys](https://docs.gitlab.com/user/project/deploy_keys): Public SSH keys, repository access, bot users, and read-only access. [Deploy tokens](https://docs.gitlab.com/user/project/deploy_tokens): Repository cloning, token creation, and container registry. [Reserved project and group names](https://docs.gitlab.com/user/reserved_names): Naming conventions, restrictions, and reserved names. [Search](https://docs.gitlab.com/user/search): Basic, advanced, exact, search scope, and commit SHA search. [Badges](https://docs.gitlab.com/user/project/badges): Pipeline status, group, project, and custom badges. [Project topics](https://docs.gitlab.com/user/project/project_topics): Project organization, subscribe, and view. [Code intelligence](https://docs.gitlab.com/user/project/code_intelligence): Set up code intelligence using LSIF or SCIP indexers to enable code navigation features. [System notes](https://docs.gitlab.com/user/project/system_notes): Track and view system-generated activity notes on work items. [Use a project as a Go package](https://docs.gitlab.com/user/project/use_project_as_go_package): Go modules and import calls. [Tutorial: Build a protected workflow for your project](https://docs.gitlab.com/tutorials/protected_workflow): Configure branch protections and approval workflows for your project. [Troubleshooting](https://docs.gitlab.com/user/project/troubleshooting): Problem solving, common issues, debugging, and error resolution. ### Plan and track work [Plan and track work](https://docs.gitlab.com/topics/plan_and_track): Epics, issues, milestones, and labels. [Getting started](https://docs.gitlab.com/user/get_started/get_started_planning_work): Plan and execute on work. [Tutorials](https://docs.gitlab.com/tutorials/plan_and_track): Planning, agile, issue boards. [Tutorial: Use GitLab for Scrum](https://docs.gitlab.com/tutorials/scrum_events): Sprints, backlog, user stories, and scrum lifecycle. [Tutorial: Use GitLab for Kanban](https://docs.gitlab.com/tutorials/kanban): Work in progress, flow, and distribution. [Work items](https://docs.gitlab.com/user/work_items): Organize your team's work with GitLab work items. Track tasks, epics, issues, and objectives in a unified view to connect strategy with implementation and monitor progress. [Labels](https://docs.gitlab.com/user/project/labels): Project labels, group labels, nested scopes, and filtering. [Iterations](https://docs.gitlab.com/user/group/iterations): Time-boxed workflow, program increments, cadence, and sprints. [Milestones](https://docs.gitlab.com/user/project/milestones): Burndown charts, goals, progress tracking, and releases. [Comments and threads](https://docs.gitlab.com/user/discussions): Use comments and threads to discuss and manage work item conversations. [Requirements](https://docs.gitlab.com/user/project/requirements): Acceptance criteria, requirements test reports, and CSV import. [Time tracking](https://docs.gitlab.com/user/project/time_tracking): Estimates, time spent, and reporting. [Customer relations (CRM)](https://docs.gitlab.com/user/crm): Customer management, organizations, contacts, and permissions. [Wikis](https://docs.gitlab.com/user/project/wiki): Documentation, external wikis, wiki events, and history. [Roadmaps](https://docs.gitlab.com/user/group/roadmap): Epic progress, timelines, milestones, and goals. [Objectives and key results (OKR)](https://docs.gitlab.com/user/okrs): Create, edit, and maintain objectives and key results (OKRs). [Keyboard shortcuts](https://docs.gitlab.com/user/shortcuts): Global shortcuts, navigation, and quick access. [Quick actions](https://docs.gitlab.com/user/project/quick_actions): Commands, shortcuts, and inline actions. [Markdown](https://docs.gitlab.com/user/markdown): Formatting, inline HTML, GitLab-specific references, diagrams, and flowcharts. [To-Do List](https://docs.gitlab.com/user/todos): Task management, actions, and access changes. [GitLab Query Language (GLQL)](https://docs.gitlab.com/user/glql) ### Manage authentication and authorization [Manage authentication and authorization](https://docs.gitlab.com/auth): User identity, authentication, permissions, access controls, and security best practices. [User identity](https://docs.gitlab.com/administration/auth): Authentication methods such as LDAP, OmniAuth, SAML, SCIM, OIDC, and OAuth [User authentication](https://docs.gitlab.com/auth/user_authentication): Passwords, two-factor authentication, SSH keys, access tokens, credentials inventory. [User permissions](https://docs.gitlab.com/auth/user_permissions): User types, roles, permissions, membership, custom roles, and access controls. [Auth best practices](https://docs.gitlab.com/auth/auth_practices): Security recommendations and best practices for authentication, authorization, and access management. [Auth glossary](https://docs.gitlab.com/auth/auth_glossary): Authentication, authorization, permissions, roles, and access control terminology. ### Use Git [Use Git](https://docs.gitlab.com/topics/git): Common Git commands and workflows. [Getting started](https://docs.gitlab.com/topics/git/get_started): Work with the Git version control system. [Tutorials](https://docs.gitlab.com/tutorials/learn_git): Git basics. [Basic operations](https://docs.gitlab.com/topics/git/basics): Learn basic Git operations to manage your repositories. [Advanced operations](https://docs.gitlab.com/topics/git/advanced): Rebase, cherry-pick, revert changes, repository, and file management. [Troubleshooting](https://docs.gitlab.com/topics/git/troubleshooting_git): Troubleshoot and resolve common Git errors and connection issues. ### Manage your code [Manage your code](https://docs.gitlab.com/topics/manage_code): Repositories, merge requests, remote development. [Getting started](https://docs.gitlab.com/user/get_started/get_started_managing_code): Build, track, and deliver the code for your project. [Repositories](https://docs.gitlab.com/user/project/repository): How to create, clone, and use GitLab repositories. [Merge requests](https://docs.gitlab.com/user/project/merge_requests): Create merge requests to review code changes, manage discussions, and merge branches. [Remote development](https://docs.gitlab.com/user/project/remote_development): Use your web browser to write code in a secure environment. ### Use CI/CD to build your application [Use CI/CD to build your application](https://docs.gitlab.com/topics/build_your_application): Runners, jobs, pipelines, variables. [Getting started](https://docs.gitlab.com/ci): Build and test your application. [Tutorials](https://docs.gitlab.com/tutorials/build_application): CI/CD fundamentals and examples. [CI/CD YAML syntax reference](https://docs.gitlab.com/ci/yaml): Pipeline configuration keywords, syntax, examples, and inputs. [Runners](https://docs.gitlab.com/ci/runners): Configuration and job execution. [Pipelines](https://docs.gitlab.com/ci/pipelines): Configuration, automation, stages, schedules, and efficiency. [Jobs](https://docs.gitlab.com/ci/jobs): Configuration, rules, caching, artifacts, and logs. [CI/CD components](https://docs.gitlab.com/ci/components): Reusable, versioned CI/CD components for pipelines. [CI/CD inputs](https://docs.gitlab.com/ci/inputs): Use typed, validated input parameters to customize reusable CI/CD templates and components. [CI/CD variables](https://docs.gitlab.com/ci/variables): Configuration, usage, and security. [Pipeline security](https://docs.gitlab.com/ci/pipeline_security): Secrets management, job tokens, secure files, and cloud security. [GitLab Secrets Manager](https://docs.gitlab.com/ci/secrets/secrets_manager) [External secrets](https://docs.gitlab.com/ci/secrets) [Debugging](https://docs.gitlab.com/ci/debugging): Configuration validation, warnings, errors, and troubleshooting. [Auto DevOps](https://docs.gitlab.com/topics/autodevops): Automated DevOps, language detection, deployment, and customization. [Testing](https://docs.gitlab.com/ci/testing): Generate test reports, code quality analysis, and security scans that display in merge requests. [Google Cloud integration](https://docs.gitlab.com/ci/gitlab_google_cloud_integration): Cloud services and Kubernetes deployments. [Migrate to GitLab CI/CD](https://docs.gitlab.com/ci/migration/plan_a_migration): Migrate from Jenkins, GitHub Actions, and others. [External repository integrations](https://docs.gitlab.com/ci/ci_cd_for_external_repos): Use GitLab CI/CD with GitHub, Bitbucket, and other external repositories. [Mobile DevOps](https://docs.gitlab.com/ci/mobile_devops) ### Secure your application [Secure your application](https://docs.gitlab.com/user/application_security/secure_your_application): Container, dependency, and vulnerability scans. [Getting started](https://docs.gitlab.com/user/application_security/get-started-security): Test your application and resolve vulnerabilities. [Tutorials](https://docs.gitlab.com/tutorials/secure_application): Dependency and compliance scanning. [Application security](https://docs.gitlab.com/user/application_security): Scanning, vulnerabilities, compliance, customization, and reporting. [Compliance](https://docs.gitlab.com/user/compliance): Compliance features. [Detect](https://docs.gitlab.com/user/application_security/detect): Vulnerability detection and result evaluation. [Triage](https://docs.gitlab.com/user/application_security/triage): Vulnerability separation by status. [Analyze](https://docs.gitlab.com/user/application_security/analyze): Vulnerability analysis and evaluation. [Remediate](https://docs.gitlab.com/user/application_security/remediate): Fix or eliminate the root cause of a vulnerability. [GitLab advisory database](https://docs.gitlab.com/user/application_security/gitlab_advisory_database): Security advisories, vulnerabilities, dependencies, database, and updates. [CVE ID requests](https://docs.gitlab.com/user/application_security/cve_id_request): Vulnerability tracking and security disclosure. [Policies](https://docs.gitlab.com/user/application_security/policies): Security policies, enforcement, compliance, approvals, and scans. [Security glossary](https://docs.gitlab.com/user/application_security/terminology): Definitions for terms related to security features in GitLab. ### Deploy and release your application [Deploy and release your application](https://docs.gitlab.com/topics/release_your_application): Environments, packages, review apps, GitLab Pages. [Getting started](https://docs.gitlab.com/user/get_started/get_started_deploy_release): Deploy and manage dependencies. [Tutorials](https://docs.gitlab.com/tutorials/deploy_release): Deployment processes and targets. [Packages & Registries](https://docs.gitlab.com/user/packages): Package management, container registry, artifact storage, and dependency management. [Environments](https://docs.gitlab.com/ci/environments): Environments, variables, dashboards, and review apps. [Deployments](https://docs.gitlab.com/ci/environments/deployments): Deployments, rollbacks, safety, and approvals. [Releases](https://docs.gitlab.com/user/project/releases): Releases, versioning, assets, tags, milestones, and evidence. [Roll out an application incrementally](https://docs.gitlab.com/ci/environments/incremental_rollouts): Kubernetes, CI/CD, risk mitigation, and deployment. [Feature flags](https://docs.gitlab.com/operations/feature_flags): Create and maintain custom feature flags for your application. [GitLab Pages](https://docs.gitlab.com/user/project/pages): Publish static websites from your repository with automatic CI/CD deployment. ### Manage your infrastructure [Manage your infrastructure](https://docs.gitlab.com/user/infrastructure): Terraform and Kubernetes deployments. [Getting started](https://docs.gitlab.com/user/get_started/get_started_managing_infrastructure): Employ best practices for managing your infrastructure. [Tutorials](https://docs.gitlab.com/tutorials/infrastructure): GitOps, Kubernetes deployments. [Infrastructure as Code](https://docs.gitlab.com/user/infrastructure/iac): Infrastructure management, versioning, automation, state storage, and modules. [Create Kubernetes clusters](https://docs.gitlab.com/user/clusters/create): Amazon EKS, Azure AKS, and Civo. [Connect Kubernetes clusters](https://docs.gitlab.com/user/clusters/agent): Kubernetes integration, GitOps, CI/CD, agent deployment, and cluster management. [Runbooks](https://docs.gitlab.com/user/project/clusters/runbooks): Executable runbooks, automation, troubleshooting, and operations. ### Monitor your application [Monitor your application](https://docs.gitlab.com/operations): Track errors and manage incident response. [Getting started](https://docs.gitlab.com/user/get_started/get_started_monitoring): Monitor your app and respond to incidents. [Error tracking](https://docs.gitlab.com/operations/error_tracking): Error tracking, logging, debugging, and data retention. [Incident management](https://docs.gitlab.com/operations/incident_management): Alert handling, response coordination, and escalation procedures. [Observability](https://docs.gitlab.com/operations/observability/observability): Monitor application performance and troubleshoot performance issues. ### Analyze GitLab usage [Analyze GitLab usage](https://docs.gitlab.com/user/analytics): Instance, group, and project analytics. [Value streams dashboard](https://docs.gitlab.com/user/analytics/value_streams_dashboard): View DevSecOps metrics (such as DORA and vulnerabilities) across your organization on a customizable dashboard. [Value stream analytics](https://docs.gitlab.com/user/group/value_stream_analytics) [GitLab Duo and SDLC trends](https://docs.gitlab.com/user/analytics/duo_and_sdlc_trends) [DevOps adoption by instance](https://docs.gitlab.com/administration/analytics/devops_adoption): Monitor DevSecOps adoption in your GitLab instance, track feature usage, and get insights into team performance. [DevOps adoption by group](https://docs.gitlab.com/user/group/devops_adoption) [Usage trends](https://docs.gitlab.com/administration/analytics/usage_trends) [Insights](https://docs.gitlab.com/user/project/insights) [Analytics dashboards](https://docs.gitlab.com/user/analytics/analytics_dashboards): Visualize metrics about DevSecOps and AI features for your projects and groups, and track performance trends. [Issue analytics](https://docs.gitlab.com/user/group/issues_analytics) [Merge request analytics](https://docs.gitlab.com/user/analytics/merge_request_analytics): Merge request analytics help you understand the efficiency of your code review process, and the productivity of your team. [Productivity analytics](https://docs.gitlab.com/user/analytics/productivity_analytics): Analyze a group's development velocity and view charts for merge request analytics. [Code review analytics](https://docs.gitlab.com/user/analytics/code_review_analytics): Learn how long your open merge requests have spent in code review, and what distinguishes the longest-running. [Contribution analytics](https://docs.gitlab.com/user/group/contribution_analytics) [Contributor analytics](https://docs.gitlab.com/user/analytics/contributor_analytics) [Repository analytics for projects](https://docs.gitlab.com/user/analytics/repository_analytics) [Repository analytics for groups](https://docs.gitlab.com/user/group/repositories_analytics) [CI/CD analytics](https://docs.gitlab.com/user/analytics/ci_cd_analytics) [DORA metrics](https://docs.gitlab.com/user/analytics/dora_metrics): Gain insights into DevOps performance and identify opportunities for workflow improvements. [DORA metrics charts](https://docs.gitlab.com/user/analytics/dora_metrics_charts) ### Release notes [Release notes](https://docs.gitlab.com/releases): GitLab release announcements and feature highlights [GitLab 19](https://docs.gitlab.com/releases/19) [GitLab 18](https://docs.gitlab.com/releases/18): GitLab version 18 release announcements with new features and improvements [GitLab 17](https://docs.gitlab.com/releases/17): GitLab version 17 release announcements with new features and improvements [GitLab 16](https://docs.gitlab.com/releases/16): GitLab version 16 release announcements with new features and improvements [Patch release notes](https://docs.gitlab.com/releases/patches): GitLab patch release announcements [Other patch release notes](https://docs.gitlab.com/releases/other-patches) ### Feature support [Feature support](https://docs.gitlab.com/policy/development_stages_support): Support details. ### Find your GitLab version [Find your GitLab version](https://docs.gitlab.com/user/version): Version information. ## GitLab Duo [GitLab Duo](https://docs.gitlab.com/user/gitlab_duo): Get help from a suite of AI-native features while you work in GitLab. ### GitLab Duo Agent Platform [GitLab Duo Agent Platform](https://docs.gitlab.com/user/duo_agent_platform): Explore AI-powered agents and flows that automate tasks across the software development lifecycle. [Getting started](https://docs.gitlab.com/user/get_started/get_started_agent_platform): Use AI-native features throughout your development lifecycle. [Project onboarding](https://docs.gitlab.com/user/duo_agent_platform/onboarding) [Tutorials](https://docs.gitlab.com/tutorials/duo): AI-native features and workflows. [Availability](https://docs.gitlab.com/user/duo_agent_platform/turn_on_off): Control GitLab Duo Agent Platform availability for groups, projects, and instances. [Agentic Chat](https://docs.gitlab.com/user/gitlab_duo_chat/agentic_chat): Use GitLab Duo Agentic Chat to answer complex questions and create or edit files autonomously. [AI Catalog](https://docs.gitlab.com/user/duo_agent_platform/ai_catalog): Discover, enable, and manage agents and flows from a central catalog. [Agents](https://docs.gitlab.com/user/duo_agent_platform/agents): Learn about foundational, custom, and external agents available in the GitLab Duo Agent Platform. [Flows](https://docs.gitlab.com/user/duo_agent_platform/flows): Use foundational and custom flows to automate complex development tasks with multiple agents. [Sessions](https://docs.gitlab.com/user/duo_agent_platform/sessions): View and manage the status and execution data for agents and flows you have run. [Customization](https://docs.gitlab.com/user/duo_agent_platform/customize): Customize GitLab Duo Agent Platform behavior to match your workflow, coding standards, and project requirements. [Code Suggestions](https://docs.gitlab.com/user/duo_agent_platform/code_suggestions): Code Suggestions helps you write code in GitLab more efficiently by using AI to suggest code as you type. [Models](https://docs.gitlab.com/user/duo_agent_platform/model_selection): Configure large language models for GitLab Duo features. [Contextual awareness](https://docs.gitlab.com/user/duo_agent_platform/context): Understand what context is available to GitLab Duo features and how to control what information they can access. [Composite identity](https://docs.gitlab.com/user/duo_agent_platform/composite_identity): Learn how composite identity combines a service account and a human user into a single token to enable secure, traceable agent actions. [Authentication](https://docs.gitlab.com/user/duo_agent_platform/authentication) [Security threats](https://docs.gitlab.com/user/duo_agent_platform/security_threats): Understand common security threats in agentic systems, including prompt injection, and how to mitigate them to protect your agents and flows. [Model Context Protocol](https://docs.gitlab.com/user/gitlab_duo/model_context_protocol): Describes Model Context Protocol and how to use it [Knowledge Graph](https://docs.gitlab.com/user/project/repository/knowledge_graph): Create structured, queryable representations of code repositories to power AI features and enhance developer productivity with the GitLab Knowledge Graph. [Troubleshooting](https://docs.gitlab.com/user/duo_agent_platform/troubleshooting): Troubleshoot common issues with the GitLab Duo Agent Platform, including flows, permissions, and push rule configuration. ### GitLab Duo Non-Agentic [GitLab Duo Non-Agentic](https://docs.gitlab.com/user/gitlab_duo/feature_summary): AI-native features and functionality. [Getting started](https://docs.gitlab.com/user/get_started/getting_started_gitlab_duo): Use AI-native features throughout your development lifecycle. [Availability](https://docs.gitlab.com/user/gitlab_duo/turn_on_off): Turn off GitLab Duo features for instances, groups, and projects. [Chat](https://docs.gitlab.com/user/gitlab_duo_chat): Use GitLab Duo Chat to ask questions about your code, get help with GitLab, and complete tasks in the GitLab UI or your IDE. [Code Suggestions](https://docs.gitlab.com/user/project/repository/code_suggestions): Code Suggestions helps you write code in GitLab more efficiently by using AI to suggest code as you type. [Code Review](https://docs.gitlab.com/user/gitlab_duo/code_review) [Custom review instructions](https://docs.gitlab.com/user/gitlab_duo/customize_duo/review_instructions): Customize instructions for AI to use in merge request reviews. [Contextual awareness](https://docs.gitlab.com/user/gitlab_duo/context): Learn what information GitLab Duo can access to provide suggestions, and how to exclude sensitive content from Code Review context. [Amazon Q](https://docs.gitlab.com/user/duo_amazon_q) [Models](https://docs.gitlab.com/user/gitlab_duo/model_selection): Configure large language models for GitLab Duo features. [Prompt examples](https://docs.gitlab.com/user/gitlab_duo/prompt_examples): Prompt examples. [Troubleshooting](https://docs.gitlab.com/user/gitlab_duo/troubleshooting) ### Data usage [Data usage](https://docs.gitlab.com/user/gitlab_duo/data_usage): AI-native features and functionality. [Prompt guardrails](https://docs.gitlab.com/user/gitlab_duo/prompt_guardrails): AI-native features and functionality. ## Orbit [Orbit](https://docs.gitlab.com/orbit): Query your GitLab instance as a knowledge graph. Find blast radius, trace dependencies, and answer SDLC questions that GitLab alone cannot. ### Orbit Remote [Orbit Remote](https://docs.gitlab.com/orbit/remote): Orbit running on GitLab-hosted infrastructure [Getting started](https://docs.gitlab.com/orbit/remote/getting-started): Enable Orbit Remote on GitLab.com and run your first query. [How it works](https://docs.gitlab.com/orbit/remote/how-it-works): How Orbit Remote indexes GitLab data and source code, builds a graph in ClickHouse, and exposes it as a queryable API. [What Orbit indexes](https://docs.gitlab.com/orbit/remote/indexing): What data Orbit indexes, which languages are supported for code indexing, and how indexing is scoped. [Schema reference](https://docs.gitlab.com/orbit/remote/schema): Full reference for all 24 Orbit node types across 6 domains, including properties and their types. [Cookbook](https://docs.gitlab.com/orbit/remote/cookbook): Copy-paste Orbit queries for common use cases including blast radius analysis, onboarding, dependency mapping, pipeline health, and vulnerability tracing. [Queries](https://docs.gitlab.com/orbit/remote/queries): Query the Orbit knowledge graph to find GitLab data, code, and relationships. [GitLab Duo Agent Platform](https://docs.gitlab.com/orbit/remote/access/duo): Use Orbit through GitLab Duo Agent Platform. Agents call Orbit's graph tools to ground their answers in your live GitLab data, across the GitLab Duo Agent, the Planner Agent, the Security Analyst Agent, the Data Analyst Agent, the CI Expert Agent, and the Developer Flow. [MCP](https://docs.gitlab.com/orbit/remote/access/mcp): Connect Claude Code, Codex, or any MCP-compatible AI agent to Orbit using the two MCP tools query_graph and get_graph_schema. [glab orbit](https://docs.gitlab.com/orbit/remote/access/glab): Query Orbit from the command line with glab orbit remote, available in glab 1.94 or later. The glab orbit setup helper is planned for a future glab release. [REST API](https://docs.gitlab.com/orbit/remote/access/api): Query the Orbit knowledge graph directly using the REST API. Reference for all four endpoints with authentication requirements and example requests. ### Orbit Local [Orbit Local](https://docs.gitlab.com/orbit/local): Orbit Local - build and query a code graph on your own machine, no GitLab instance required. [Getting started](https://docs.gitlab.com/orbit/local/getting-started): Pick an access method and build your first local Orbit graph. [How it works](https://docs.gitlab.com/orbit/local/how-it-works): How Orbit Local builds and queries a code graph on your machine using the Orbit CLI and DuckDB. [What Orbit indexes](https://docs.gitlab.com/orbit/local/indexing): What Orbit Local indexes on your machine, which languages are supported, and the boundaries of the local code graph. [Schema reference](https://docs.gitlab.com/orbit/local/schema): Reference for the four node types in the Orbit Local code graph and how they connect. [orbit CLI](https://docs.gitlab.com/orbit/local/access/cli): Build and query a local code graph with the Orbit CLI (orbit) binary. No GitLab account or network connection required. [glab orbit](https://docs.gitlab.com/orbit/local/access/glab): Install, index, and query Orbit Local through the GitLab CLI with glab orbit local and glab orbit setup. The local mcp serve command is planned. [MCP](https://docs.gitlab.com/orbit/local/access/mcp): Connect Claude Code, Codex, or any MCP-compatible AI agent to your local Orbit graph. ## Extend ### Tutorials [Tutorials](https://docs.gitlab.com/tutorials/develop): Integrations with third-party services. ### Integrations [Integrations](https://docs.gitlab.com/integration): Projects, issues, authentication, security providers. [Project integrations](https://docs.gitlab.com/user/project/integrations): User documentation for project and group integrations. Includes a list of available integrations. [Akismet](https://docs.gitlab.com/integration/akismet) [Apple App Store Connect](https://docs.gitlab.com/user/project/integrations/apple_app_store) [Asana](https://docs.gitlab.com/user/project/integrations/asana): Configure the Asana integration to add commit messages as comments to Asana tasks and close tasks from GitLab commits. [Atlassian Bamboo](https://docs.gitlab.com/user/project/integrations/bamboo) [AWS CodePipeline](https://docs.gitlab.com/user/project/integrations/aws_codepipeline) [Beyond Identity](https://docs.gitlab.com/user/project/integrations/beyond_identity): Integrate GitLab with Beyond Identity to verify GPG keys added to user accounts. [ChatOps](https://docs.gitlab.com/ci/chatops) [ClickHouse](https://docs.gitlab.com/integration/clickhouse) [Confluence Workspace](https://docs.gitlab.com/user/project/integrations/confluence) [Datadog](https://docs.gitlab.com/integration/datadog) [Diagram proxy](https://docs.gitlab.com/administration/integration/diagram_proxy) [Diagrams.net](https://docs.gitlab.com/administration/integration/diagrams_net): Configure a Diagrams.net integration for GitLab. [Diffblue Cover](https://docs.gitlab.com/integration/diffblue_cover): How to configure the Diffblue Cover GitLab integration - Cover Pipeline for GitLab [Discord Notifications](https://docs.gitlab.com/user/project/integrations/discord_notifications): Configure the Discord notifications integration to receive notifications from GitLab in Discord channels. [Elasticsearch](https://docs.gitlab.com/integration/advanced_search/elasticsearch): Set up and configure Elasticsearch to use advanced search in GitLab. [Emails on push](https://docs.gitlab.com/user/project/integrations/emails_on_push) [External issue trackers](https://docs.gitlab.com/integration/external-issue-tracker) [GitGuardian](https://docs.gitlab.com/user/project/integrations/git_guardian): Integrate GitLab with GitGuardian to get alerts for policy violations and security issues before they can be exploited. [GitHub](https://docs.gitlab.com/user/project/integrations/github): Send GitLab CI/CD pipeline status updates to GitHub. [GitLab for Slack app](https://docs.gitlab.com/user/project/integrations/gitlab_slack_application): Configure the GitLab for Slack app to use slash commands, receive notifications, and interact with GitLab Duo from your Slack workspace. [Gitpod](https://docs.gitlab.com/integration/gitpod): Use Ona to build and configure prebuilt development environments for your GitLab project. [Gmail actions](https://docs.gitlab.com/integration/gmail_action_buttons_for_gitlab): Configure Gmail actions for GitLab notifications. [Google Chat](https://docs.gitlab.com/user/project/integrations/hangouts_chat): Configure the Google Chat integration to receive notifications from GitLab in a Google Chat space. [Google Play](https://docs.gitlab.com/user/project/integrations/google_play) [Harbor](https://docs.gitlab.com/user/project/integrations/harbor): Configure Harbor as an open-source container registry for your GitLab project to manage artifacts across platforms. [irker (IRC gateway)](https://docs.gitlab.com/user/project/integrations/irker): Configure the irker integration to send GitLab push notifications to IRC channels. [Jenkins](https://docs.gitlab.com/integration/jenkins) [Jira](https://docs.gitlab.com/integration/jira) [Kroki](https://docs.gitlab.com/administration/integration/kroki) [Mailgun](https://docs.gitlab.com/administration/integration/mailgun) [Matrix notifications](https://docs.gitlab.com/user/project/integrations/matrix) [Mattermost notifications](https://docs.gitlab.com/user/project/integrations/mattermost): Configure Mattermost notifications to receive notifications from GitLab in Mattermost channels. [Mattermost slash commands](https://docs.gitlab.com/user/project/integrations/mattermost_slash_commands): Configure Mattermost slash commands to run common GitLab operations from a Mattermost chat environment. [Microsoft Teams notifications](https://docs.gitlab.com/user/project/integrations/microsoft_teams): Configure the Microsoft Teams integration to receive notifications from GitLab in Microsoft Teams. [MLflow](https://docs.gitlab.com/user/project/ml/experiment_tracking/mlflow_client) [Mock CI](https://docs.gitlab.com/user/project/integrations/mock_ci) [Pipeline status emails](https://docs.gitlab.com/user/project/integrations/pipeline_status_emails) [Pivotal Tracker](https://docs.gitlab.com/user/project/integrations/pivotal_tracker) [PlantUML](https://docs.gitlab.com/administration/integration/plantuml): Configure PlantUML integration with GitLab Self-Managed. [Pumble](https://docs.gitlab.com/user/project/integrations/pumble): Configure GitLab to send notifications to a Pumble channel. [reCAPTCHA](https://docs.gitlab.com/integration/recaptcha) [Slack notifications (deprecated)](https://docs.gitlab.com/user/project/integrations/slack) [Snowflake](https://docs.gitlab.com/integration/snowflake) [Sourcegraph](https://docs.gitlab.com/integration/sourcegraph) [Squash TM](https://docs.gitlab.com/user/project/integrations/squash_tm) [Telegram](https://docs.gitlab.com/user/project/integrations/telegram): Configure the Telegram integration to receive notifications from GitLab in Telegram chats or channels. [Trello Power-Ups](https://docs.gitlab.com/integration/trello_power_up) [Unify Circuit](https://docs.gitlab.com/user/project/integrations/unify_circuit): Configure GitLab to send event notifications to Unify Circuit conversations. [Vault](https://docs.gitlab.com/integration/vault) [Webex Teams](https://docs.gitlab.com/user/project/integrations/webex_teams): Send event notifications from GitLab to Webex Teams spaces with webhooks. [Zentao](https://docs.gitlab.com/user/project/integrations/zentao) [Zoekt](https://docs.gitlab.com/integration/zoekt) ### Webhooks [Webhooks](https://docs.gitlab.com/user/project/integrations/webhooks): Configure and manage project and group webhooks in GitLab. [Events](https://docs.gitlab.com/user/project/integrations/webhook_events): List of GitLab webhook events and payloads. Includes JSON examples. [Rake tasks](https://docs.gitlab.com/administration/raketasks/web_hooks) [Troubleshooting](https://docs.gitlab.com/user/project/integrations/webhooks_troubleshooting): Custom HTTP callbacks, used to send events. ### REST API [Automate storage management](https://docs.gitlab.com/user/storage_management_automation) ### GitLab Duo CLI (duo) [GitLab Duo CLI (duo)](https://docs.gitlab.com/user/gitlab_duo_cli): Command-line interface tool that brings the GitLab Duo Agent Platform to your terminal. ### Editor and IDE extensions [Editor and IDE extensions](https://docs.gitlab.com/editor_extensions): Extend the features of GitLab to Visual Studio Code, JetBrains IDEs, Visual Studio, Eclipse, and Neovim. [Visual Studio Code](https://docs.gitlab.com/editor_extensions/visual_studio_code): Use the GitLab for VS Code extension to handle common GitLab tasks directly in VS Code. [JetBrains IDEs](https://docs.gitlab.com/editor_extensions/jetbrains_ide): Connect and use GitLab Duo in JetBrains IDEs. [Visual Studio](https://docs.gitlab.com/editor_extensions/visual_studio): Connect and use GitLab Duo in Visual Studio. [Eclipse](https://docs.gitlab.com/editor_extensions/eclipse): Connect and use GitLab Duo in Eclipse. [Neovim](https://docs.gitlab.com/editor_extensions/neovim): Connect and use GitLab Duo in Neovim. [Language Server](https://docs.gitlab.com/editor_extensions/language_server): Learn about the GitLab Language Server. [Security considerations](https://docs.gitlab.com/editor_extensions/security_considerations): Security considerations for using GitLab editor extensions and CLI tools with local agent execution. ## Install [Install](https://docs.gitlab.com/install): Read through the GitLab installation methods. ### Requirements [Requirements](https://docs.gitlab.com/install/requirements): Prerequisites for installation. ### Installation methods [Installation methods](https://docs.gitlab.com/install/install_methods): Linux, Helm, Docker, Operator, source, or scripts. [Linux package](https://docs.gitlab.com/install/package): Install, configure, and upgrade GitLab by using the Linux package. [Helm chart](https://docs.gitlab.com/charts) [Operator](https://docs.gitlab.com/operator) [Docker](https://docs.gitlab.com/install/docker): Install, configure, back up, and upgrade GitLab in a Docker container. [Self-compiled](https://docs.gitlab.com/install/self_compiled): Install GitLab from source on Debian or Ubuntu by compiling and configuring each component manually. ### Cloud providers [Cloud providers](https://docs.gitlab.com/install/cloud_providers): AWS, Google Cloud Platform, Azure. [Azure](https://docs.gitlab.com/install/azure): Install GitLab from Azure Marketplace. [Google Cloud Platform (GCP)](https://docs.gitlab.com/install/google_cloud_platform): Install a GitLab instance on a virtual machine in Google Cloud Platform. [Amazon Web Services (AWS)](https://docs.gitlab.com/install/aws): Install GitLab on AWS using community AMIs provided by GitLab. ### Offline GitLab [Offline GitLab](https://docs.gitlab.com/topics/offline): Isolated installation. [Offline GitLab installation](https://docs.gitlab.com/topics/offline/quick_start_guide): Install, configure, and use a GitLab Self-Managed instance in an environment with no internet access. ### Reference architectures [Reference architectures](https://docs.gitlab.com/administration/reference_architectures): Recommended deployments at scale. [Assess size](https://docs.gitlab.com/administration/reference_architectures/sizing): Guide to define Reference Architecture size and component-specific adjustments. [Up to 20 RPS or 1,000 users](https://docs.gitlab.com/administration/reference_architectures/1k_users): Deploy a GitLab Self-Managed instance for up to 1,000 users or 20 RPS with a single-node installation and recommended sizing. [Up to 40 RPS or 2,000 users](https://docs.gitlab.com/administration/reference_architectures/2k_users): Deploy a GitLab Self-Managed instance for up to 2,000 users or 40 RPS with multi-node components and recommended sizing. [Up to 60 RPS or 3,000 users](https://docs.gitlab.com/administration/reference_architectures/3k_users): Deploy a GitLab Self-Managed instance for up to 3,000 users or 60 RPS with high-availability components and recommended sizing. [Up to 100 RPS or 5,000 users](https://docs.gitlab.com/administration/reference_architectures/5k_users): Deploy GitLab for 5,000 users with this reference architecture. Configure high-availability components and supporting services. [Up to 200 RPS or 10,000 users](https://docs.gitlab.com/administration/reference_architectures/10k_users): Deploy and scale a GitLab Self-Managed instance for up to 10,000 users or 200 RPS with high availability, database replication, and infrastructure sizing. [Up to 500 RPS or 25,000 users](https://docs.gitlab.com/administration/reference_architectures/25k_users): Deploy a GitLab Self-Managed instance for up to 25,000 users or 500 RPS with high availability, database replication, and infrastructure sizing. [Up to 1,000 RPS or 50,000 users](https://docs.gitlab.com/administration/reference_architectures/50k_users): Deploy a GitLab Self-Managed instance for up to 50,000 users or 1000 RPS with high availability, database replication, and infrastructure sizing. [Cloud Native First](https://docs.gitlab.com/administration/reference_architectures/cloud_native_first): Deploy all GitLab components in Kubernetes using Cloud Native First reference architectures with four standardized sizes and external PostgreSQL, Redis, and object storage. ### Steps after installing [Steps after installing](https://docs.gitlab.com/install/next_steps): Configure email, authentication, CI/CD, GitLab Duo, and other features after installing GitLab. ### Upgrade GitLab [Upgrade GitLab](https://docs.gitlab.com/update): Upgrade GitLab to later versions. [Before you upgrade](https://docs.gitlab.com/update/plan_your_upgrade): Steps to take before you upgrade. [Upgrade a GitLab instance](https://docs.gitlab.com/update/upgrade): Upgrade steps for all installation methods. [Troubleshooting and rolling back](https://docs.gitlab.com/update/troubleshooting_and_rolling_back): Troubleshoot or roll back a GitLab instance upgrade [Releases and maintenance](https://docs.gitlab.com/policy/maintenance): Version support, release cadence, and backporting policies. [Other upgrade paths](https://docs.gitlab.com/update/convert_to_ee): Move between different editions or installation methods. ### Install GitLab Runner [Install GitLab Runner](https://docs.gitlab.com/runner/install): Software for CI/CD jobs. [System requirements and supported platforms](https://docs.gitlab.com/runner/install/requirements): Software for CI/CD jobs. [Linux](https://docs.gitlab.com/runner/install/linux-repository): Install GitLab Runner from a GitLab repository using your package manager. [Linux manual install](https://docs.gitlab.com/runner/install/linux-manually): Manually download and install the GitLab Runner binary on Linux. [FreeBSD](https://docs.gitlab.com/runner/install/freebsd): Install GitLab Runner on FreeBSD systems. [macOS](https://docs.gitlab.com/runner/install/osx): Download, install, and configure GitLab Runner as a user-mode service on Apple Silicon and Intel x86-64 systems. [Windows](https://docs.gitlab.com/runner/install/windows): Install GitLab Runner on Windows systems. [Docker](https://docs.gitlab.com/runner/install/docker): Run GitLab Runner in a Docker container. [Helm chart](https://docs.gitlab.com/runner/install/kubernetes): Install GitLab Runner in Kubernetes using the GitLab Helm chart. [GitLab agent](https://docs.gitlab.com/runner/install/kubernetes-agent): Install GitLab Runner using the GitLab agent for Kubernetes. [Operator](https://docs.gitlab.com/runner/install/operator): Install GitLab Runner using the GitLab Operator for Kubernetes. [z/OS](https://docs.gitlab.com/runner/install/z-os): Install GitLab Runner manually on z/OS. [Step runner](https://docs.gitlab.com/runner/install/step-runner): Install step runner manually to use GitLab Functions [Bleeding edge releases](https://docs.gitlab.com/runner/install/bleeding-edge): Install the latest development builds of GitLab Runner. [Support policy](https://docs.gitlab.com/runner/install/support-policy) ### Configure GitLab Runner [Configure GitLab Runner](https://docs.gitlab.com/runner/configuration): Configuration, certificates, autoscaling, proxy setup. [Advanced configuration](https://docs.gitlab.com/runner/configuration/advanced-configuration) [Commands](https://docs.gitlab.com/runner/commands) [Feature flags](https://docs.gitlab.com/runner/configuration/feature-flags) [macOS setup](https://docs.gitlab.com/runner/configuration/macos_setup) [Runner Operator on OpenShift](https://docs.gitlab.com/runner/configuration/configuring_runner_operator) [Configure GitLab Runner for OCI](https://docs.gitlab.com/runner/configuration/oracle_cloud_performance) [Running behind a proxy](https://docs.gitlab.com/runner/configuration/proxy) [Graphical processing units](https://docs.gitlab.com/runner/configuration/gpus) [Self-signed certificates](https://docs.gitlab.com/runner/configuration/tls-self-signed) [System services](https://docs.gitlab.com/runner/configuration/init) [Speed up job execution](https://docs.gitlab.com/runner/configuration/speed_up_job_execution) [Slot-based cgroup support](https://docs.gitlab.com/runner/configuration/slot_based_cgroups) [Tutorial: Configure GitLab Runner to use the Google Kubernetes Engine](https://docs.gitlab.com/tutorials/configure_gitlab_runner_to_use_gke): Learn how to configure GitLab Runner to run CI/CD jobs in Google Kubernetes Engine using the Kubernetes Operator. [Troubleshooting](https://docs.gitlab.com/runner/faq) ## Administer [Administer](https://docs.gitlab.com/administration): Learn how to install, configure, update, and maintain your GitLab instance. ### Getting started [Getting started](https://docs.gitlab.com/administration/get_started): Administration overview. ### Configure GitLab [Configure GitLab](https://docs.gitlab.com/administration/configure): Configuration settings. [Admin area](https://docs.gitlab.com/administration/admin_area): Manage your GitLab instance and configure features in the UI. [GitLab Relay (KAS)](https://docs.gitlab.com/administration/clusters/kas): Manage GitLab Relay (KAS). [Application cache interval](https://docs.gitlab.com/administration/application_settings_cache): Manage the GitLab application cache. [Cells](https://docs.gitlab.com/administration/cells): Configure and test GitLab Cells functionality for GitLab.com administrators as part of functionality testing, including enabling Cell instances and configuring topology service clients. [CI/CD](https://docs.gitlab.com/administration/cicd): Manage GitLab CI/CD configuration. [ClickHouse for analytics](https://docs.gitlab.com/administration/analytics): Enable and configure ClickHouse for data analytics in GitLab. [Consul](https://docs.gitlab.com/administration/consul): Configure a Consul cluster. [Cron](https://docs.gitlab.com/topics/cron): Schedule when jobs should run. [Custom HTML header tags](https://docs.gitlab.com/administration/custom_html_header_tags): Learn how to modify the HTML header tags of your GitLab instance. [Environment variables](https://docs.gitlab.com/administration/environment_variables): Override supported environment variables. [File hooks](https://docs.gitlab.com/administration/file_hooks): Create custom file hooks to integrate your GitLab Self-Managed instance with external services without modifying source code. [Geo](https://docs.gitlab.com/administration/geo): Geographically distribute GitLab. [Disaster recovery (Geo)](https://docs.gitlab.com/administration/geo/disaster_recovery): Recover from a disaster, using a Geo instance. [Geo sites](https://docs.gitlab.com/administration/geo_sites): Configure Geo sites. [Git LFS administration](https://docs.gitlab.com/administration/lfs): Configure Git LFS for GitLab Self-Managed. [Git protocol v2](https://docs.gitlab.com/administration/git_protocol): Set and configure Git protocol v2 for GitLab Self-Managed. [Health check](https://docs.gitlab.com/administration/monitoring/health_check): Perform health, liveness, and readiness checks. [Host the product documentation](https://docs.gitlab.com/administration/docs_self_host): Host the product documentation yourself. [Incoming email](https://docs.gitlab.com/administration/incoming_email): Configure incoming email. [Instance limits](https://docs.gitlab.com/administration/instance_limits): Configure limits on an instance. [Instance review](https://docs.gitlab.com/administration/instance_review): Request a free instance review. [Invalidate Markdown cache](https://docs.gitlab.com/administration/invalidate_markdown_cache): Invalidate the Markdown cache. [Issue closing pattern](https://docs.gitlab.com/administration/issue_closing_pattern): Instance administrators can configure a custom issue closing pattern for their GitLab instance. [Labels](https://docs.gitlab.com/administration/labels): Configure labels to add to new projects. [Load balancer](https://docs.gitlab.com/administration/load_balancer): Use a load balancer with multi-node a multi-node instance. [Log system](https://docs.gitlab.com/administration/logs): Access comprehensive logging and monitoring capabilities. [Merge request approvals](https://docs.gitlab.com/administration/merge_requests_approvals): Configure merge request approvals for your GitLab instance. [Merge request diffs storage](https://docs.gitlab.com/administration/merge_request_diffs): Configure external storage for merge request diffs on your GitLab instance. [NFS](https://docs.gitlab.com/administration/nfs): Use NFS with GitLab. [Object storage](https://docs.gitlab.com/administration/object_storage): Configure an object storage service for data. [Packages](https://docs.gitlab.com/administration/packages): Administer the package registry. [Postfix](https://docs.gitlab.com/administration/reply_by_email_postfix_setup): Configure Postfix for incoming email. [PostgreSQL](https://docs.gitlab.com/administration/postgresql): Configure PostgreSQL for scaling. [Redis](https://docs.gitlab.com/administration/redis): Configure Redis for scaling. [Reply by email](https://docs.gitlab.com/administration/reply_by_email): Configure comments on issues and merge requests with replies by email. [Repository storage](https://docs.gitlab.com/administration/repository_storage_paths): How GitLab stores repository data. [Secrets Manager](https://docs.gitlab.com/administration/secrets_manager) [Server hooks](https://docs.gitlab.com/administration/server_hooks): Configure Git server hooks. [Sidekiq](https://docs.gitlab.com/administration/sidekiq): Configure an external Sidekiq instance. [Snippets](https://docs.gitlab.com/administration/snippets): Configure snippets settings for your GitLab instance. [S/MIME signing](https://docs.gitlab.com/administration/smime_signing_email): Configure S/MIME for outgoing email. [Static objects external storage](https://docs.gitlab.com/administration/static_objects_external_storage): Configure external storage, such as a CDN, for static objects in your GitLab repository. [Terraform limits](https://docs.gitlab.com/administration/settings/terraform_limits): Configure Terraform storage limits. [Terraform state](https://docs.gitlab.com/administration/terraform_state): Administer Terraform state storage. [Terraform state settings](https://docs.gitlab.com/administration/settings/terraform_state_settings): Configure Terraform state encryption and storage limits. [Timezone](https://docs.gitlab.com/administration/timezone): Change the time zone for an instance. [Uploads](https://docs.gitlab.com/administration/uploads): Administer uploads storage. [Web terminals](https://docs.gitlab.com/administration/integration/terminal): Information about Web terminals. [What's new](https://docs.gitlab.com/administration/whats-new): Configure the What's new feature. [Wikis](https://docs.gitlab.com/administration/wikis): Configure Wiki settings. ### Configure GitLab Duo [Configure GitLab Duo](https://docs.gitlab.com/administration/gitlab_duo/configure): Configure GitLab Duo for your GitLab instance. [GitLab Dedicated for Government](https://docs.gitlab.com/administration/gitlab_duo/configure/gitlab_dedicated_for_government): Ensure GitLab Duo is configured and operating correctly on GitLab Dedicated for Government. [AI Catalog rake tasks](https://docs.gitlab.com/administration/raketasks/ai_catalog) [Self-hosted models](https://docs.gitlab.com/administration/gitlab_duo_self_hosted): Host your own AI Gateway and language models. [GitLab Duo AI Gateway](https://docs.gitlab.com/administration/gitlab_duo/gateway) [Model selection](https://docs.gitlab.com/administration/gitlab_duo/model_selection): Configure large language models for GitLab Duo features. ### Update your settings [Update your settings](https://docs.gitlab.com/administration/settings): Product settings. [Account and limit settings](https://docs.gitlab.com/administration/settings/account_and_limit_settings): Configure the maximum number of projects users can create on GitLab Self-Managed. Configure size limits for attachments, pushes, and repository size. [Appearance](https://docs.gitlab.com/administration/appearance): Customize your GitLab instance appearance, including logos, favicons, sign-in pages, Progressive Web App settings, system messages, and color themes. [CI/CD](https://docs.gitlab.com/administration/settings/continuous_integration) [Configure Editor Extensions](https://docs.gitlab.com/administration/settings/editor_extensions): Configure GitLab editor extensions for Visual Studio Code, JetBrains IDEs, Visual Studio, Eclipse, and Neovim. [Configure VS Code Extension Marketplace](https://docs.gitlab.com/administration/settings/vscode_extension_marketplace): Configure VS Code Extension Marketplace for features on the GitLab Self-Managed instance. [Web IDE extension host domain](https://docs.gitlab.com/administration/settings/web_ide): Indicate the wildcard domain used by the Web IDE to isolate VS Code extensions and web views [Custom project templates for your instance](https://docs.gitlab.com/administration/custom_project_templates): Configure project templates and make them available to all projects on your GitLab instance. [Diff limits](https://docs.gitlab.com/administration/diff_limits): Configure the maximum diff size to display on GitLab Self-Managed. [Email](https://docs.gitlab.com/administration/settings/email) [External authorization](https://docs.gitlab.com/administration/settings/external_authorization) [Federated Learning of Cohorts (FLoC)](https://docs.gitlab.com/administration/settings/floc) [GitLab for Jira Cloud app](https://docs.gitlab.com/administration/settings/jira_cloud_app) [GitLab for Slack app](https://docs.gitlab.com/administration/settings/slack_app): Administer, configure, and troubleshoot the GitLab for Slack app on GitLab Self-Managed instances. [GitLab Pages](https://docs.gitlab.com/administration/pages) [Import and export settings](https://docs.gitlab.com/administration/settings/import_and_export_settings): Configure settings for import sources, export limits, file sizes, user mapping, and placeholder users on your GitLab Self-Managed instance. [Instance template repository](https://docs.gitlab.com/administration/settings/instance_template_repository): Configure a collection of file templates available for all projects. [IP address restrictions](https://docs.gitlab.com/administration/reporting/ip_addr_restrictions) [Localization](https://docs.gitlab.com/administration/settings/localization) [Maintenance Mode](https://docs.gitlab.com/administration/maintenance_mode) [Polling interval multiplier](https://docs.gitlab.com/administration/polling) [Project integrations](https://docs.gitlab.com/administration/settings/project_integration_management): Configure and manage settings for project and group integrations on GitLab Self-Managed instances. [Protected paths](https://docs.gitlab.com/administration/settings/protected_paths) [Public security contact information](https://docs.gitlab.com/administration/settings/security_contact_information) [Push event activities limit](https://docs.gitlab.com/administration/settings/push_event_activities_limit): Configure limits on the number of single push events your instance allows. [Repository checks](https://docs.gitlab.com/administration/repository_checks) [Security and Compliance](https://docs.gitlab.com/administration/settings/security_and_compliance): Configure security and compliance administration settings, including which package repositories are synchronized. [Sign-in and help page text](https://docs.gitlab.com/administration/settings/help_page) [Sign-in restrictions](https://docs.gitlab.com/administration/settings/sign_in_restrictions) [Sign-up restrictions](https://docs.gitlab.com/administration/settings/sign_up_restrictions) [Spamcheck](https://docs.gitlab.com/administration/reporting/spamcheck) [System Hooks](https://docs.gitlab.com/administration/system_hooks): Use system hooks to trigger HTTP POST requests from GitLab events. Includes JSON payload examples. [Terms of service and privacy policy](https://docs.gitlab.com/administration/settings/terms) [Third-party offers](https://docs.gitlab.com/administration/settings/third_party_offers) [Visibility and access controls](https://docs.gitlab.com/administration/settings/visibility_and_access_controls): Control project visibility, creation, retention, and deletion. ### Enable features behind feature flags [Enable features behind feature flags](https://docs.gitlab.com/administration/feature_flags): GitLab administrator: enable and disable GitLab features deployed behind feature flags [List of all feature flags](https://docs.gitlab.com/administration/feature_flags/list): Complete list of all feature flags in GitLab. ### Maintain GitLab [Maintain GitLab](https://docs.gitlab.com/administration/operations): Backup and restore, move repositories, maintenance tasks. [Housekeeping](https://docs.gitlab.com/administration/housekeeping): Housekeeping tasks for Git repositories. [Activate GitLab EE with license](https://docs.gitlab.com/administration/license_file): Activate GitLab Enterprise Edition with a license file or key. [License usage](https://docs.gitlab.com/administration/license_usage): View and export usage associated with your GitLab license. [Import and export large projects](https://docs.gitlab.com/administration/raketasks/project_import_export): Rake tasks for importing and exporting large projects. [Fast SSH key lookup](https://docs.gitlab.com/administration/operations/fast_ssh_key_lookup): Configure a faster SSH authorization method for GitLab instances with many users. [Filesystem benchmarking](https://docs.gitlab.com/administration/operations/filesystem_benchmarking): Benchmark file system performance. [gitlab-sshd](https://docs.gitlab.com/administration/operations/gitlab_sshd): Configure a lightweight alternative to OpenSSH for your GitLab instance. [Rails console](https://docs.gitlab.com/administration/operations/rails_console): Interact with your GitLab instance from the command line. [Use SSH certificates](https://docs.gitlab.com/administration/operations/ssh_certificates): Configure authorized principals for SSH certificate authentication. [Enable encrypted configuration](https://docs.gitlab.com/administration/encrypted_configuration): Enable encrypted configuration settings for certain features. [Rake tasks](https://docs.gitlab.com/administration/raketasks): Administration and operational Rake tasks. [Backup and restore](https://docs.gitlab.com/administration/backup_restore): Back up and restore a GitLab instance. [Dormant project deletion](https://docs.gitlab.com/administration/dormant_project_deletion): Configure deletion of dormant projects. [Migrate to a subdomain](https://docs.gitlab.com/administration/operations/migrate_to_subdomain): Reconfigure a GitLab instance to use a subdomain instead of a relative URL. [Move repositories](https://docs.gitlab.com/administration/operations/moving_repositories): Move projects, snippets, and groups between servers and storages. [Silent mode](https://docs.gitlab.com/administration/silent_mode): Silence outbound communication from GitLab. [Read-only state](https://docs.gitlab.com/administration/read_only_gitlab): Place GitLab into a read-only state. [Restart GitLab](https://docs.gitlab.com/administration/restart_gitlab): How to restart GitLab. [Troubleshooting](https://docs.gitlab.com/administration/troubleshooting): Troubleshooting a GitLab installation. ### Monitor GitLab [Monitor GitLab](https://docs.gitlab.com/administration/monitoring): Performance, health, uptime monitoring. [Performance monitoring](https://docs.gitlab.com/administration/monitoring/performance) [Prometheus](https://docs.gitlab.com/administration/monitoring/prometheus) [Configure Grafana](https://docs.gitlab.com/administration/monitoring/performance/grafana_configuration) [Performance bar](https://docs.gitlab.com/administration/monitoring/performance/performance_bar) [GitHub imports](https://docs.gitlab.com/administration/monitoring/github_imports): Use Prometheus metrics to monitor GitHub imports into your GitLab Self-Managed instance. [GitLab exporter](https://docs.gitlab.com/administration/monitoring/prometheus/gitlab_exporter) [GitLab Prometheus metrics](https://docs.gitlab.com/administration/monitoring/prometheus/gitlab_metrics) [IP allowlist endpoints](https://docs.gitlab.com/administration/monitoring/ip_allowlist) [Node exporter](https://docs.gitlab.com/administration/monitoring/prometheus/node_exporter) [PGBouncer exporter](https://docs.gitlab.com/administration/monitoring/prometheus/pgbouncer_exporter) [PostgreSQL server exporter](https://docs.gitlab.com/administration/monitoring/prometheus/postgres_exporter) [Redis exporter](https://docs.gitlab.com/administration/monitoring/prometheus/redis_exporter) [Registry exporter](https://docs.gitlab.com/administration/monitoring/prometheus/registry_exporter) [Usage statistics](https://docs.gitlab.com/administration/settings/usage_statistics) [Event data](https://docs.gitlab.com/administration/settings/event_data) [Web exporter](https://docs.gitlab.com/administration/monitoring/prometheus/web_exporter) ### Secure GitLab [Secure GitLab](https://docs.gitlab.com/security): SSH key limits, 2FA, tokens, hardening. [Compliance](https://docs.gitlab.com/administration/compliance/compliance_features): Compliance center, audit events, security policies, and compliance frameworks. [Instance compliance and security policy management](https://docs.gitlab.com/security/compliance_security_policy_management): Learn how to apply security policies and compliance frameworks across multiple groups and projects from a single, centralized location. [Rate limits](https://docs.gitlab.com/security/rate_limits) [Filtering outbound requests](https://docs.gitlab.com/security/webhooks) [Manage the CRIME vulnerability](https://docs.gitlab.com/security/crime_vulnerability) [Identity verification](https://docs.gitlab.com/security/identity_verification) [Make new users confirm email](https://docs.gitlab.com/security/user_email_confirmation) [Runners](https://docs.gitlab.com/runner/security) [Proxying assets](https://docs.gitlab.com/security/asset_proxy) [TLS support](https://docs.gitlab.com/security/tls_support) [Rotate secrets of third-party integrations](https://docs.gitlab.com/security/rotate_integrations_secrets) [Respond to security incidents](https://docs.gitlab.com/security/responding_to_security_incidents) [GitLab Dedicated for Government shared responsibility model](https://docs.gitlab.com/security/dedicated_for_government_shared_responsibility_model) [GitLab Dedicated for Government secure configuration guide](https://docs.gitlab.com/security/dedicated_for_government_secure_config_guide) [Hardening](https://docs.gitlab.com/security/hardening) ### Administer users [Administer users](https://docs.gitlab.com/administration/administer_users): Administer GitLab users. [Create users](https://docs.gitlab.com/user/profile/account/create_accounts): Create user accounts in GitLab. [Delete users](https://docs.gitlab.com/user/profile/account/delete_account): Remove user accounts and manage associated records and contributions. [Reset user passwords](https://docs.gitlab.com/security/reset_user_password): Change user passwords using the UI, Rake tasks, Rails console, or API. [Locked user accounts](https://docs.gitlab.com/security/unlock_user): Unlock accounts that are locked after failed sign-in attempts. [User file uploads](https://docs.gitlab.com/security/user_file_uploads): Manage access control and security for files uploaded to issues, merge requests, and epics. [Configure the Libravatar service](https://docs.gitlab.com/administration/libravatar): Set up avatar services for user profiles using Gravatar, Libravatar, or custom services. [Modify global user settings](https://docs.gitlab.com/administration/user_settings): Configure instance-wide user settings like group creation and username changes. [Moderate users](https://docs.gitlab.com/administration/moderate_users): Block, deactivate, ban, or trust users to control instance access and activity. [Review abuse reports](https://docs.gitlab.com/administration/review_abuse_reports): View and resolve abuse reports submitted by users. [Review spam logs](https://docs.gitlab.com/administration/review_spam_logs): Monitor and manage flagged user activity considered to be spam. [User cohorts](https://docs.gitlab.com/administration/user_cohorts): Analyze user retention and activity trends over time. [Broadcast messages](https://docs.gitlab.com/administration/broadcast_messages): Send banners and notifications to users on your instance. [Email from GitLab](https://docs.gitlab.com/administration/email_from_gitlab): Send email notifications to all users or specific groups and projects. [User management Rake tasks](https://docs.gitlab.com/administration/raketasks/user_management): Perform bulk user operations and manage authentication settings using Rake tasks. ### Administer GitLab Dedicated [Administer GitLab Dedicated](https://docs.gitlab.com/administration/dedicated): Get started with GitLab Dedicated. [Architecture](https://docs.gitlab.com/administration/dedicated/architecture): Get to know the GitLab Dedicated architecture through a series of diagrams. [Create your GitLab Dedicated instance](https://docs.gitlab.com/administration/dedicated/create_instance): Complete the Switchboard onboarding process to create and access your GitLab Dedicated instance. [View your instance details](https://docs.gitlab.com/administration/dedicated/tenant_overview): Check instance health and find maintenance windows for your GitLab Dedicated instance in Switchboard. [Configure GitLab Dedicated](https://docs.gitlab.com/administration/dedicated/configure_instance): Configure your GitLab Dedicated instance with Switchboard. [Authenticated user rate limits](https://docs.gitlab.com/administration/dedicated/user_rate_limits): Authenticated user rate limits for GitLab Dedicated, default limits by reference architecture, and handling strategies. [Encryption](https://docs.gitlab.com/administration/dedicated/encryption): Configure encryption for GitLab Dedicated with GitLab-managed keys or your own encryption keys. [Hosted runners](https://docs.gitlab.com/administration/dedicated/hosted_runners): Use hosted runners to run your CI/CD jobs on GitLab Dedicated. [Monitor your instance](https://docs.gitlab.com/administration/dedicated/monitor): Manage access to application logs for your GitLab Dedicated instance. [Maintenance operations](https://docs.gitlab.com/administration/dedicated/maintenance): Scheduled maintenance windows, emergency procedures, and contact management for GitLab Dedicated instances. [Releases and versioning](https://docs.gitlab.com/administration/dedicated/releases): Release schedules, versioning model, and patch processes for GitLab Dedicated instances. [Disaster recovery](https://docs.gitlab.com/administration/dedicated/disaster_recovery): Recovery objectives, failover process, and regional backup strategies for GitLab Dedicated instances. ### Administer GitLab Runner [Administer GitLab Runner](https://docs.gitlab.com/runner) [Getting started](https://docs.gitlab.com/user/get_started/get_started_runner): Set up and manage GitLab Runner. [Create and manage runners](https://docs.gitlab.com/ci/runners/runners_scope): Learn about the types of runners, their availability, and how to manage them. [Register a runner](https://docs.gitlab.com/runner/register) [Runner executors](https://docs.gitlab.com/runner/executors) [Configure runners](https://docs.gitlab.com/ci/runners/configure_runners): Set timeouts, protect sensitive information, control behavior with tags and variables, and configure artifact and cache settings of your GitLab Runner. [Autoscale configuration](https://docs.gitlab.com/runner/runner_autoscale) [Monitor runner performance](https://docs.gitlab.com/runner/monitoring): Prometheus metrics. [Runner fleet configuration and best practices](https://docs.gitlab.com/topics/runner_fleet_design_guides): Runner Fleet. ## Subscribe [Subscribe](https://docs.gitlab.com/subscriptions): Choose and manage the subscription that's right for you and your organization. ### GitLab plans [GitLab plans](https://docs.gitlab.com/subscriptions/choosing_subscription): Choose the right GitLab subscription for your needs. [Ultimate trials](https://docs.gitlab.com/subscriptions/free_trials): Start an Ultimate trial on GitLab.com or GitLab Self-Managed. [Activate Enterprise Edition](https://docs.gitlab.com/administration/license): Activate GitLab Enterprise Edition with an activation code to unlock paid features. Learn to activate your subscription for new, scaled, or offline instances. ### GitLab Credits [GitLab Credits](https://docs.gitlab.com/subscriptions/gitlab_credits): Understand how GitLab Credits work and view your credit usage. ### Manage subscription [Manage subscription](https://docs.gitlab.com/subscriptions/manage_subscription): Buy, view, and renew your GitLab subscriptions. [Troubleshooting](https://docs.gitlab.com/subscriptions/gitlab_com/gitlab_subscription_troubleshooting): Seat usage, compute minutes, storage limits, renewal info. ### Manage billing account [Manage billing account](https://docs.gitlab.com/subscriptions/billing_account): Change billing account data and payment methods, pay for invoices, and link your GitLab account in the Customers Portal. ### Manage seats [Manage seats](https://docs.gitlab.com/subscriptions/manage_seats): Manage users and seats associated with your GitLab subscription. [Compute minutes](https://docs.gitlab.com/subscriptions/gitlab_com/compute_minutes): Purchase additional compute minutes for group and personal namespaces on GitLab.com, including monthly rollover and troubleshooting. [Free tier user and group limits](https://docs.gitlab.com/user/free_user_limit) [Free push limit](https://docs.gitlab.com/user/free_push_limit) [Read-only namespaces and projects](https://docs.gitlab.com/user/read_only_namespaces) [Storage](https://docs.gitlab.com/user/storage_usage_quotas) [Billing for seat overages](https://docs.gitlab.com/subscriptions/quarterly_reconciliation): Understand the billing processes for seat overages on your GitLab subscription. ### GitLab Dedicated [GitLab Dedicated](https://docs.gitlab.com/subscriptions/gitlab_dedicated): Discover available features and benefits of a single-tenant SaaS solution. [GitLab Dedicated for Government](https://docs.gitlab.com/subscriptions/gitlab_dedicated_for_government): Single-tenant SaaS solution for government agencies and regulated industries. ### GitLab Duo add-ons [GitLab Duo add-ons](https://docs.gitlab.com/subscriptions/subscription-add-ons): Discover GitLab Duo subscription add-ons and assign seats. [GitLab Duo trials](https://docs.gitlab.com/subscriptions/gitlab_duo_trials): Seat assignment, GitLab Duo subscription add-on. ### Community programs [Community programs](https://docs.gitlab.com/subscriptions/community_programs): Use GitLab for Education, Open Source, and Startups.