gitlab-org--gitlab-foss/doc/gitlab-basics/README.md

---
comments: false
type: index
---

# GitLab basics guides

This section provides resources to help you start working with GitLab and Git by focusing
on the basic features that you will need to use.

This documentation is split into the following groups:

- [GitLab-specific functionality](#gitlab-basics), for basic GitLab features.
- [General Git functionality](#working-with-git-from-the-command-line), for working
  with Git in conjunction with GitLab.

## GitLab basics

The following are guides to basic GitLab functionality:

- [Create and add your SSH public key](create-your-ssh-keys.md), for enabling Git over SSH.
- [Create a project](create-project.md), to start using GitLab.
- [Create a group](../user/group/index.md#create-a-new-group), to combine and administer
  projects together.
- [Create a branch](create-branch.md), to make changes to files stored in a project's repository.
- [Feature branch workflow](feature_branch_workflow.md).
- [Fork a project](fork-project.md), to duplicate projects so they can be worked on in parallel.
- [Add a file](add-file.md), to add new files to a project's repository.
- [Create an issue](../user/project/issues/managing_issues.md#create-a-new-issue),
  to start collaborating within a project.
- [Create a merge request](add-merge-request.md), to request changes made in a branch
  be merged into a project's repository.
- See how these features come together in the [GitLab Flow introduction video](https://youtu.be/InKNIvky2KE)
  and [GitLab Flow page](../topics/gitlab_flow.md).

## Working with Git from the command line

If you're familiar with Git on the command line, you can interact with your GitLab
projects just as you would with any other Git repository.

These resources will help you get further acclimated to working on the command line.

- [Start using Git on the command line](start-using-git.md), for some simple Git commands.
- [Command line basics](command-line-commands.md), to create and edit files using the command line.

More Git resources are available in GitLab's [Git documentation](../topics/git/index.md).
Exclude comments from specific docs 2017-11-01 11:56:40 -04:00			`---`
			`comments: false`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`type: index`
Exclude comments from specific docs 2017-11-01 11:56:40 -04:00			`---`

MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00			`# GitLab basics guides`

First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`This section provides resources to help you start working with GitLab and Git by focusing`
			`on the basic features that you will need to use.`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00
			`This documentation is split into the following groups:`

			`- [GitLab-specific functionality](#gitlab-basics), for basic GitLab features.`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`- [General Git functionality](#working-with-git-from-the-command-line), for working`
			`with Git in conjunction with GitLab.`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00
			`## GitLab basics`

			`The following are guides to basic GitLab functionality:`

Refactor GitLab basics ssh keys docs Ensures we give instructions for how to create ssh keys in a single place only. 2019-05-29 10:33:32 -04:00			`- [Create and add your SSH public key](create-your-ssh-keys.md), for enabling Git over SSH.`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00			`- [Create a project](create-project.md), to start using GitLab.`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`- [Create a group](../user/group/index.md#create-a-new-group), to combine and administer`
			`projects together.`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00			`- [Create a branch](create-branch.md), to make changes to files stored in a project's repository.`
Add latest changes from gitlab-org/gitlab@master 2019-10-28 02:06:30 -04:00			`- [Feature branch workflow](feature_branch_workflow.md).`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00			`- [Fork a project](fork-project.md), to duplicate projects so they can be worked on in parallel.`
			`- [Add a file](add-file.md), to add new files to a project's repository.`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`- [Create an issue](../user/project/issues/managing_issues.md#create-a-new-issue),`
			`to start collaborating within a project.`
			`- [Create a merge request](add-merge-request.md), to request changes made in a branch`
			`be merged into a project's repository.`
			`- See how these features come together in the [GitLab Flow introduction video](https://youtu.be/InKNIvky2KE)`
Add latest changes from gitlab-org/gitlab@master 2019-10-27 02:06:30 -04:00			`and [GitLab Flow page](../topics/gitlab_flow.md).`
Added link to GitFlow video 2019-06-11 21:05:18 -04:00
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`## Working with Git from the command line`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`If you're familiar with Git on the command line, you can interact with your GitLab`
			`projects just as you would with any other Git repository.`
Update README to add more context on Git Basics 2019-05-01 13:22:14 -04:00
Add latest changes from gitlab-org/gitlab@master 2019-12-15 19:07:33 -05:00			`These resources will help you get further acclimated to working on the command line.`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00
			`- [Start using Git on the command line](start-using-git.md), for some simple Git commands.`
Update README to add more context on Git Basics 2019-05-01 13:22:14 -04:00			`- [Command line basics](command-line-commands.md), to create and edit files using the command line.`
MVC improvements to basics landing page 2019-04-30 14:04:19 -04:00
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`More Git resources are available in GitLab's [Git documentation](../topics/git/index.md).`