Skip to content
GitLab

Create a project (FREE)

You can create a project in many ways in GitLab.

Create a blank project

To create a blank project:

  1. On the top bar, select Main menu > Projects > View all projects.
  2. On the right of the page, select New project.
  3. Select Create blank project.
  4. Enter the project details:
    • In the Project name field, enter the name of your project. You cannot use special characters at the start or end of a project name.
    • In the Project slug field, enter the path to your project. The GitLab instance uses the slug as the URL path to the project. To change the slug, first enter the project name, then change the slug.
    • In the Project deployment target (optional) field, select your project's deployment target. This information helps GitLab better understand its users and their deployment requirements.
    • To modify the project's viewing and access rights for users, change the Visibility Level.
    • To create README file so that the Git repository is initialized, has a default branch, and can be cloned, select Initialize repository with a README.
    • To analyze the source code in the project for known security vulnerabilities, select Enable Static Application Security Testing (SAST).
  5. Select Create project.

Create a project from a built-in template

A built-in project template populates a new project with files to get you started. Built-in templates are sourced from the following groups:

Anyone can contribute a built-in template.

To create a project from a built-in template:

  1. On the top bar, select Main menu > Projects > View all projects.
  2. On the right of the page, select New project.
  3. Select Create from template.
  4. Select the Built-in tab.
  5. From the list of templates:
    • To view a preview of the template, select Preview.
    • To use a template for the project, select Use template.
  6. Enter the project details:
    • In the Project name field, enter the name of your project. You cannot use special characters at the start or end of a project name.
    • In the Project slug field, enter the path to your project. The GitLab instance uses the slug as the URL path to the project. To change the slug, first enter the project name, then change the slug.
    • In the Project description (optional) field, enter the description of your project's dashboard.
    • To modify the project's viewing and access rights for users, change the Visibility Level.
  7. Select Create project.

Create a project from a custom template (PREMIUM)

Introduced in GitLab 11.2.

Custom project templates are available at:

  1. On the top bar, select Main menu > Projects > View all projects.
  2. On the right of the page, select New project.
  3. Select Create from template.
  4. Select the Instance or Group tab.
  5. From the list of templates:
    • To view a preview of the template, select Preview.
    • To use a template for the project, select Use template.
  6. Enter the project details:
    • In the Project name field, enter the name of your project. You cannot use special characters at the start or end of a project name.
    • In the Project slug field, enter the path to your project. The GitLab instance uses the slug as the URL path to the project. To change the slug, first enter the project name, then change the slug.
    • The description of your project's dashboard in the Project description (optional) field.
    • To modify the project's viewing and access rights for users, change the Visibility Level.
  7. Select Create project.

Create a project from the HIPAA Audit Protocol template (ULTIMATE)

Introduced in GitLab 12.10

The HIPAA Audit Protocol template contains issues for audit inquiries in the HIPAA Audit Protocol published by the U.S Department of Health and Human Services.

To create a project from the HIPAA Audit Protocol template:

  1. On the top bar, select Main menu > Projects > View all projects.
  2. On the right of the page, select New project.
  3. Select Create from template.
  4. Select the Built-in tab.
  5. Locate the HIPAA Audit Protocol template:
    • To view a preview of the template, select Preview.
    • To use the template for the project, select Use template.
  6. Enter the project details:
    • In the Project name field, enter the name of your project. You cannot use special characters at the start or end of a project name.
    • In the Project slug field, enter the path to your project. The GitLab instance uses the slug as the URL path to the project. To change the slug, first enter the project name, then change the slug.
    • In the Project description (optional) field, enter the description of your project's dashboard.
    • To modify the project's viewing and access rights for users, change the Visibility Level.
  7. Select Create project.

Create a new project with Git push

Introduced in GitLab 10.5.

Use git push to push a local project repository to GitLab. After you push a repository, GitLab creates your project in your chosen namespace.

You cannot use git push to create projects with project paths that:

  • Have previously been used.
  • Have been renamed.

Previously used project paths have a redirect. The redirect causes push attempts to redirect requests to the renamed project location, instead of creating a new project. To create a new project for a previously used or renamed project, use the UI or the Projects API.

Prerequisites:

  • To push with SSH, you must have an SSH key that is added to your GitLab account.

  • You must have permission to add new projects to a namespace. To check if you have permission:

    1. On the top bar, select Main menu > Groups and find your group.
    2. Confirm that New project is visible in the upper right corner. Contact your GitLab administrator if you require permission.

To push your repository and create a project:

  1. Push with SSH or HTTPS:

    • To push with SSH:

      git push --set-upstream git@gitlab.example.com:namespace/myproject.git master

    • To push with HTTPS:

      git push --set-upstream https://gitlab.example.com/namespace/myproject.git master

    • For gitlab.example.com, use the domain name of the machine that hosts your Git repository.

    • For namespace, use the name of your namespace.

    • For myproject, use the name of your project.

    • Optional. To export existing repository tags, append the --tags flag to your git push command.

  2. Optional. To configure the remote:

    git remote add origin https://gitlab.example.com/namespace/myproject.git

When the push completes, GitLab displays the message:

remote: The private project namespace/myproject was created.

To view your new project, go to https://gitlab.example.com/namespace/myproject. Your project's visibility is set to Private by default. To change project visibility, adjust your project's settings.

Related topics