The following are commonly-used Git terms.
In GitLab, files are stored in a repository. A repository is similar to how you store files in a folder or directory on your computer.
- A remote repository refers to the files in GitLab.
- A local copy refers to the files on your computer.
Often, the word "repository" is shortened to "repo".
In GitLab, a repository is contained in a project.
When you want to contribute to someone else's repository, you make a copy of it. This copy is called a fork. The process is called "creating a fork."
When you fork a repo, you create a copy of the project in your own namespace. You then have write permissions to modify the project files and settings.
For example, you can fork this project, https://gitlab.com/gitlab-tests/sample-project/, into your namespace.
You now have your own copy of the repository. You can view the namespace in the URL, for example
Then you can clone the repository to your local machine, work on the files, and submit changes back to the
Difference between download and clone
To create a copy of a remote repository's files on your computer, you can either download or clone the repository. If you download it, you cannot sync the repository with the remote repository on GitLab.
Cloning a repository is the same as downloading, except it preserves the Git connection with the remote repository. You can then modify the files locally and upload the changes to the remote repository on GitLab.
Pull and push
After you save a local copy of a repository and modify the files on your computer, you can upload the
changes to GitLab. This is referred to as pushing to the remote, because you use the command
When the remote repository changes, your local copy is behind. You can update your local copy with the new
changes in the remote repository.
This is referred to as pulling from the remote, because you use the command