mirror of
https://github.com/desktop/desktop
synced 2024-08-27 04:00:55 +00:00
32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
# Authenticating to GitLab with GitHub Desktop
|
|
|
|
## Creating a Personal Access Token in GitLab
|
|
|
|
To authenticate against GitLab repositories you will need to create a personal access token.
|
|
|
|
1. Go to your GitLab account and select **Edit Profile** in the user profile dropdown.
|
|
|
|
|
|
|
|
2. In the left sidebar, 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 the token to your clipboard.
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
|
|
|
|
- **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.
|