Creating a new git repository

Creating a new git repository in is a pretty straightforward action. Depending on whether you already have a GNOME Account (and are part of the GNOME group as a direct consequence) or not, the instructions differ.

Users with a GNOME Account

0. Project Prerequisites

First, read and make sure your software matches the Projects/Prerequisites. If your software does not fulfill all those requirements, it should not be hosted on

1. Creating the repository

After logging in with your account at GNOME's GitLab instance, navigate HERE. From there you can decide whether you want to import an existing project from one of the possible external repositories hosting (GitHub, Bitbucket, etc.) or start a repository from scratch and import it manually after it has been created.

The repository name must be lowercase letters, digits, and '-'. (With an exception to allow uppercase for names starting with "perl-")

2. Importing branches from your local repository

You can now push the branches and tags you want into your new repository. If you have a local repository with exactly the tags and branches you want (use git tag -l and git branch to list your tags and branches), then you can import all branches and tags with:

git remote add origin
git push origin --all

Check to make sure that you are happy with the contents of your repository (You can browse it on the web at<repository-name>.)

Users without a GNOME Account

Please first check your project meets the Projects/Prerequisites. If all these requirements are met, send an email to <accounts AT gnome DOT org> containing:

  • The requested repository name (i.e. 'mynewproject').
  • A brief description of what the software does.
  • Links to project homepage and download page.
  • Whether you consider your project meets the Projects/Prerequisites.

Your project should be approved within a few days. If the sysadmins are busy, it can take a few weeks. Feel free to ask what's happening with your request on #sysadmin, but don't pester.

Some other ways forward for other project issues:

Git/NewRepository (last edited 2018-11-08 10:58:20 by AndreaVeri)