GitLab- Creating Projects and Groups

GitLab allows for version control of software and controlling access to the code. This guide covers the basics of logging in, connecting to your project, setting up groups with projects and members. For detailed directions on how to use GitLab for your software, see the documentation at the service itself.

Logging in:

Setting Up SSH Access (required to push code from computer to repository)

Creating a New Project

To create an individual project:

  • Select the “+” in the upper right hand corner to bring up a new project form.
  • Enter a name, description, and visibility level
  • Create “Create Project”

To create a project in a group

  • Go to the main group page (OR from a project in the group select the group name at the top)
  • Select “New Project” button on the upper right
  • Enter a name, description, and visibility level
  • Create “Create Project”


Groups allow you have several related projects (mainly permissions are consistent). It provides a consistent URL prefix to all projects within the group. It also allows you to grant permissions to all projects to other people, rather than individually by project.

Create a group:

  • Select the “+” in the upper right hand corner.
  • Chose “Create a group” just under the project name box.
  • Select the visibility of the group
  • Click “Create group”
  • This takes you to the main groups page—it is strongly suggested you create the first project immediately so it appears on your project page, otherwise you need to know the group name in order to access the group and add a project.

Add members to a group

  • Assure all group members have logged in at least once
  • From the main group page
    • Select “members” from across the top
    • Search for people you want to add
    • Select group access level
    • Add access expiration date if desired
    • Click “Add users to group” at the bottom

Get Help

Questions about this topic? Don't see what you're looking for?

Email engrit-help [at] illinois [dot] edu, call the Help Desk at 217-333-1313, or contact your primary IT support professional.