GitLab User Guide
This document provides step-by-step instructions for using GitLab for project collaboration, including project
initialization, file uploads, branch management, and code merging.
Project URL: [Link]
Table of Contents
1. Create Project and Clone to Local
Download and Install GitHub Desktop
Configure GitHub Desktop Options
Clone Project Using GitHub Desktop
2. Upload Files and Push to Remote Repository
3. Create Branch, Make Changes, and Merge to Main Branch
1. Create Project and Clone to Local
Video Tutorials:
Create Project and Clone to Local
1.1 Create Project on GitLab
1. Log in to GitLab: Visit [Link]
2. Click the "New project" button in the top right corner
3. Select "Create blank project"
4. Fill in project information:
Project name: Enter project name (e.g., test)
Project URL: Select namespace (e.g., jvnz)
Visibility Level: Choose project visibility (Internal)
5. Click "Create project" to complete
1.2 Download and Install GitHub Desktop
GitHub Desktop is a user-friendly Git GUI application that makes it easy to clone and manage Git repositories.
1. Download GitHub Desktop:
Visit: [Link]
Click "Download for Windows" (or your operating system)
The download will start automatically
2. Install GitHub Desktop:
Run the downloaded installer
Follow the installation wizard
Complete the installation process
3. Sign in to GitHub Desktop (Optional):
Open GitHub Desktop
You can sign in with GitHub account (optional, not required for GitLab)
Or skip this step and use it directly
1.3 Configure GitHub Desktop Options
Before using GitHub Desktop, it's recommended to configure basic Git settings that will be used for all your
commits.
1. Open Options Settings:
Open GitHub Desktop
Click "File" → "Options" (Windows)
2. Configure Git Settings:
In the left navigation bar, click "Git" option
You will see the following configuration items:
Name:
Enter your Git username (e.g., [Link] )
This name will appear in all your commit records
Email:
Enter your email address (e.g., [Link]@[Link] )
Make sure to use the email address associated with your GitLab account
This email will be used to identify your commits
Default branch name for new repositories:
Default is set to main
1.4 Clone Project to Local Using GitHub Desktop
Method 1: Using GitHub Desktop (Recommended for Beginners)
1. Open GitHub Desktop application
2. Add GitLab Repository:
Click "File" → "Clone Repository"
Select the "URL" tab
Enter the repository URL: [Link]
Choose a local path where you want to save the project
Click "Clone"
3. Wait for Clone to Complete:
GitHub Desktop will download the repository
You'll see a progress indicator
Once complete, the repository will appear in GitHub Desktop
4. Open Repository in File Explorer:
Right-click on the repository in GitHub Desktop
Select "Show in Explorer"
2. Upload Files and Push to Remote Repository
Video Tutorials:
Upload Files and Push to Remote
3. Create Branch, Make Changes, and Merge to Main
Branch
Video Tutorials:
Create Branch and Merge to Main