2024-10-12 11:02:34 +00:00 · 2019-03-22 11:06:11 -04:00 · 2019-03-22 11:06:11 -04:00 · b838cfeed1
parent 55f51c894d
commit b838cfeed1
1 changed files with 31 additions and 0 deletions
--- a/docs/integrations/gitlab.md
+++ b/docs/integrations/gitlab.md
@ -0,0 +1,31 @@
+# Authenticating to GitLab with GitHub Desktop
+
+## Creating a Personal Access Token in Azure DevOps
+
+To authenticate against GitLab repositories you will need to create a personal access token.
+
+1. Go to your GitLab account and select **Settings** in the user profile dropdown.
+
+![](https://user-images.githubusercontent.com/721500/54831873-8d884e00-4c91-11e9-9087-57af715d8321.png)
+
+2. Select ** Access tokens**
+
+3. Under **Add a personal access token** choose a name and set an expiration date for your token.
+
+4. For **Scopes** select `api` to ensure that GitHub Desktop has the correct read/write access to your GitLab repositories.
+
+5. Click **Create personal access token** to create a new token, and then copy your token to the clipboard.
+
+![](https://user-images.githubusercontent.com/721500/54831880-8feaa800-4c91-11e9-801b-40ed2af869a0.png)
+
+## Cloning your GitLab repository in GitHub Desktop
+
+ 1. Open GitHub Desktop and go to **File** > **Clone Repository** > **URL**. Enter the Git URL of your GitLab repository. Make sure you enter the correct URL, which should have the following structure:
+
+      `https://gitlab.com/<username>/<repository>`
+
+ 2. You will receive an `Authentication Failed` error. Enter your GitLab username and paste in the token you just copied to your clipboard as your password. Click **Save and Retry** to successfully clone the repository to your local machine in GitHub Desktop.
+
+![](https://user-images.githubusercontent.com/721500/54832263-36cf4400-4c92-11e9-8937-6617a0a564b5.png)
+
+   - **Note:** Your GitLab credentials will be securely stored on your local machine so you will not need to repeat this process when cloning another repository from GitLab.