| [**User Documentation**](user/index.md)<br/>Discover features and concepts for GitLab users. | [**Administrator documentation**](administration/index.md)<br/>Everything GitLab self-managed administrators need to know. |
| [**User Documentation**](user/index.md)<br/>Discover features and concepts for GitLab users. | [**Administrator documentation**](administration/index.md)<br/>Everything GitLab self-managed administrators need to know. |
| [**Contributing to GitLab**](#contributing-to-gitlab)<br/>At GitLab, everyone can contribute! | [**New to Git and GitLab?**](#new-to-git-and-gitlab)<br/>We have the resources to get you started. |
| [**Contributing to GitLab**](#contributing-to-gitlab)<br/>At GitLab, everyone can contribute! | [**New to Git and GitLab?**](#new-to-git-and-gitlab)<br/>We have the resources to get you started. |
| [**Building an integration with GitLab?**](#building-an-integration-with-gitlab)<br/>Consult our automation and integration documentation. | [**Coming to GitLab from another platform?**](#coming-to-gitlab-from-another-platform)<br/>Consult our handy guides. |
| [**Build an integration with GitLab?**](#build-an-integration-with-gitlab)<br/>Consult our automation and integration documentation. | [**Coming to GitLab from another platform?**](#coming-to-gitlab-from-another-platform)<br/>Consult our handy guides. |
| [**Install GitLab**](https://about.gitlab.com/install/)<br/>Installation options for different platforms. | [**Customers**](subscriptions/index.md)<br/>Information for new and existing customers. |
| [**Install GitLab**](https://about.gitlab.com/install/)<br/>Installation options for different platforms. | [**Customers**](subscriptions/index.md)<br/>Information for new and existing customers. |
| [**Update GitLab**](update/README.md)<br/>Update your GitLab self-managed instance to the latest version. | [**Reference Architectures**](administration/reference_architectures/index.md)<br/>GitLab's reference architectures |
| [**Update GitLab**](update/README.md)<br/>Update your GitLab self-managed instance to the latest version. | [**Reference Architectures**](administration/reference_architectures/index.md)<br/>GitLab's reference architectures |
| [**GitLab Releases**](https://about.gitlab.com/releases/)<br/>What's new in GitLab. | |
| [**GitLab Releases**](https://about.gitlab.com/releases/)<br/>What's new in GitLab. | |
## Popular Documentation
## Popular topics
Have a look at some of our most popular documentation resources:
| [GitLab CI/CD pipeline configuration reference](ci/yaml/README.md) | Available configuration options for `.gitlab-ci.yml` files. |
| [GitLab Pages](user/project/pages/index.md) | Host static websites for your projects with GitLab. |
| [Activate GitLab EE with a license](user/admin_area/license.md)**(STARTER ONLY)** | Activate GitLab Enterprise Edition functionality with a license. |
| [GitLab.com settings](user/gitlab_com/index.md) | Settings for GitLab.com. |
| [Back up and restore GitLab](raketasks/backup_restore.md)**(CORE ONLY)** | Rake tasks for backing up and restoring GitLab self-managed instances. |
| [Kubernetes integration](user/project/clusters/index.md) | Use GitLab with Kubernetes. |
| [GitLab release and maintenance policy](policy/maintenance.md) | Policies for version naming and cadence, and also upgrade recommendations. |
| [SSH authentication](ssh/README.md) | Secure your network communications. |
| [Elasticsearch integration](integration/elasticsearch.md)**(STARTER ONLY)** | Integrate Elasticsearch with GitLab to enable advanced searching. |
| [Using Docker images](ci/docker/using_docker_images.md) | Build and test your applications with Docker. |
| [Omnibus GitLab database settings](https://docs.gitlab.com/omnibus/settings/database.html)**(CORE ONLY)** | Database settings for Omnibus GitLab self-managed instances. |
| [GitLab Value Stream Analytics](user/project/cycle_analytics.md) | Measure the time it takes to go from an [idea to production](https://about.gitlab.com/blog/2016/08/05/continuous-integration-delivery-and-deployment-with-gitlab/#from-idea-to-production-with-gitlab) for each project you have. |
| [GitLab Value Stream Analytics](user/project/cycle_analytics.md) | Measure the time it takes to go from an [idea to production](https://about.gitlab.com/blog/2016/08/05/continuous-integration-delivery-and-deployment-with-gitlab/#from-idea-to-production-with-gitlab) for each project you have. |
...
@@ -107,7 +109,7 @@ management tools.
...
@@ -107,7 +109,7 @@ management tools.
The following documentation relates to the DevOps **Plan** stage:
The following documentation relates to the DevOps **Plan** stage:
| [Advanced global search](user/search/advanced_global_search.md)**(STARTER)** | Leverage Elasticsearch for faster, more advanced code search across your entire GitLab instance. |
| [Advanced global search](user/search/advanced_global_search.md)**(STARTER)** | Leverage Elasticsearch for faster, more advanced code search across your entire GitLab instance. |
| [Advanced syntax search](user/search/advanced_search_syntax.md)**(STARTER)** | Use advanced queries for more targeted search results. |
| [Advanced syntax search](user/search/advanced_search_syntax.md)**(STARTER)** | Use advanced queries for more targeted search results. |
...
@@ -169,7 +171,7 @@ The following documentation relates to the DevOps **Create** stage:
...
@@ -169,7 +171,7 @@ The following documentation relates to the DevOps **Create** stage:
| [Branches](user/project/repository/branches/index.md) and the [default branch](user/project/repository/branches/index.md#default-branch) | How to use branches in GitLab. |
| [Branches](user/project/repository/branches/index.md) and the [default branch](user/project/repository/branches/index.md#default-branch) | How to use branches in GitLab. |
| [Commits](user/project/repository/index.md#commits) and [signing commits](user/project/repository/gpg_signed_commits/index.md) | Work with commits, and use GPG to sign your commits. |
| [Commits](user/project/repository/index.md#commits) and [signing commits](user/project/repository/gpg_signed_commits/index.md) | Work with commits, and use GPG to sign your commits. |
...
@@ -192,7 +194,7 @@ The following documentation relates to the DevOps **Create** stage:
...
@@ -192,7 +194,7 @@ The following documentation relates to the DevOps **Create** stage:
| [Checking out merge requests locally](user/project/merge_requests/reviewing_and_managing_merge_requests.md#checkout-merge-requests-locally) | Tips for working with merge requests locally. |
| [Checking out merge requests locally](user/project/merge_requests/reviewing_and_managing_merge_requests.md#checkout-merge-requests-locally) | Tips for working with merge requests locally. |
| [Cherry-picking](user/project/merge_requests/cherry_pick_changes.md) | Use GitLab for cherry-picking changes. |
| [Cherry-picking](user/project/merge_requests/cherry_pick_changes.md) | Use GitLab for cherry-picking changes. |
...
@@ -208,7 +210,7 @@ The following documentation relates to the DevOps **Create** stage:
...
@@ -208,7 +210,7 @@ The following documentation relates to the DevOps **Create** stage:
#### Integration and Automation
#### Integration and Automation
| Create Topics - Integration and Automation | Description |
| Create topics - Integration and Automation | Description |
| [GitLab API](api/README.md) | Integrate GitLab via a simple and powerful API. |
| [GitLab API](api/README.md) | Integrate GitLab via a simple and powerful API. |
| [GitLab Integration](integration/README.md) | Integrate with multiple third-party services with GitLab to allow external issue trackers and external authentication. |
| [GitLab Integration](integration/README.md) | Integrate with multiple third-party services with GitLab to allow external issue trackers and external authentication. |
...
@@ -235,7 +237,7 @@ scales to run your tests faster.
...
@@ -235,7 +237,7 @@ scales to run your tests faster.
The following documentation relates to the DevOps **Verify** stage:
The following documentation relates to the DevOps **Verify** stage:
| [Container Registry](user/packages/container_registry/index.md) | The GitLab Container Registry enables every project in GitLab to have its own space to store [Docker](https://www.docker.com/) images. |
| [Container Registry](user/packages/container_registry/index.md) | The GitLab Container Registry enables every project in GitLab to have its own space to store [Docker](https://www.docker.com/) images. |
| [Dependency Proxy](user/packages/dependency_proxy/index.md)**(PREMIUM)** | The GitLab Dependency Proxy sets up a local proxy for frequently used upstream images/packages. |
| [Dependency Proxy](user/packages/dependency_proxy/index.md)**(PREMIUM)** | The GitLab Dependency Proxy sets up a local proxy for frequently used upstream images/packages. |
...
@@ -280,7 +282,7 @@ confidently and securely with GitLab’s built-in Continuous Delivery and Deploy
...
@@ -280,7 +282,7 @@ confidently and securely with GitLab’s built-in Continuous Delivery and Deploy
The following documentation relates to the DevOps **Release** stage:
The following documentation relates to the DevOps **Release** stage:
| [Auto Deploy](topics/autodevops/stages.md#auto-deploy) | Configure GitLab for the deployment of your application. |
| [Auto Deploy](topics/autodevops/stages.md#auto-deploy) | Configure GitLab for the deployment of your application. |
| [Canary Deployments](user/project/canary_deployments.md)**(PREMIUM)** | Employ a popular CI strategy where a small portion of the fleet is updated to the new version first. |
| [Canary Deployments](user/project/canary_deployments.md)**(PREMIUM)** | Employ a popular CI strategy where a small portion of the fleet is updated to the new version first. |
...
@@ -306,7 +308,7 @@ configuration. Then customize everything from buildpacks to CI/CD.
...
@@ -306,7 +308,7 @@ configuration. Then customize everything from buildpacks to CI/CD.
The following documentation relates to the DevOps **Configure** stage:
The following documentation relates to the DevOps **Configure** stage:
| [GitLab Performance Monitoring](administration/monitoring/performance/index.md)**(CORE ONLY)** | Use Prometheus and Grafana to monitor the performance of your GitLab instance. |
| [GitLab Performance Monitoring](administration/monitoring/performance/index.md)**(CORE ONLY)** | Use Prometheus and Grafana to monitor the performance of your GitLab instance. |
| [GitLab Prometheus](administration/monitoring/prometheus/index.md)**(CORE ONLY)** | Configure the bundled Prometheus to collect various metrics from your GitLab instance. |
| [GitLab Prometheus](administration/monitoring/prometheus/index.md)**(CORE ONLY)** | Configure the bundled Prometheus to collect various metrics from your GitLab instance. |
...
@@ -360,7 +362,7 @@ high-level view on projects and groups, and start remediation processes when nee
...
@@ -360,7 +362,7 @@ high-level view on projects and groups, and start remediation processes when nee
The following documentation relates to the DevOps **Secure** stage:
The following documentation relates to the DevOps **Secure** stage:
| [Compliance Dashboard](user/compliance/compliance_dashboard/index.md)**(ULTIMATE)** | View the most recent Merge Request activity in a group. |
| [Compliance Dashboard](user/compliance/compliance_dashboard/index.md)**(ULTIMATE)** | View the most recent Merge Request activity in a group. |
| [Container Scanning](user/application_security/container_scanning/index.md)**(ULTIMATE)** | Use Clair to scan Docker images for known vulnerabilities. |
| [Container Scanning](user/application_security/container_scanning/index.md)**(ULTIMATE)** | Use Clair to scan Docker images for known vulnerabilities. |
...
@@ -442,7 +444,7 @@ If you are coming to GitLab from another platform, you'll find the following inf
...
@@ -442,7 +444,7 @@ If you are coming to GitLab from another platform, you'll find the following inf
</a>
</a>
</div>
</div>
## Building an integration with GitLab
## Build an integration with GitLab
There are many ways to integrate with GitLab, including:
There are many ways to integrate with GitLab, including:
info:To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
info:To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
---
---
# Two-Factor Authentication
# Two-factor authentication
Two-factor Authentication (2FA) provides an additional level of security to your
Two-factor authentication (2FA) provides an additional level of security to your
GitLab account. Once enabled, in addition to supplying your username and
GitLab account. Once enabled, in addition to supplying your username and
password to login, you'll be prompted for a code generated by your one time password
password to login, you'll be prompted for a code generated by your one time password
authenticator. For example, a password manager on one of your devices.
authenticator. For example, a password manager on one of your devices.
...
@@ -62,7 +62,7 @@ To enable 2FA:
...
@@ -62,7 +62,7 @@ To enable 2FA:
1. Click **Submit**.
1. Click **Submit**.
If the pin you entered was correct, you'll see a message indicating that
If the pin you entered was correct, you'll see a message indicating that
Two-Factor Authentication has been enabled, and you'll be presented with a list
two-factor authentication has been enabled, and you'll be presented with a list
of [recovery codes](#recovery-codes). Make sure you download them and keep them
of [recovery codes](#recovery-codes). Make sure you download them and keep them