Creating a new git repository

Creating a new git repository in involves several steps. Depending on whether you already have a git account or not, the instructions differ.

Users with a git 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


ssh <username> create-repository <repository-name>

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

Once you've done that, your repository is in a special "pending" mode indicating that the import is not complete, and will show up on prepending with [PENDING]. Normal pushes to you repository are not allowed as long as it is pending.

2. Importing branches from your local repository

You can now push the branches and tags you want into your new repository by adding --exec=import to the normal git push line. 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 push --exec=import ssh://<username><repository-name> refs/heads/* refs/tags/*

You can also push just the branches you want one-by-one, again adding --exec=import to the push line.

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

3. Finishing the import

Once you are satisfied, finish the import process by running:

ssh <username> finish-import <repository-name>

Once you have done this, you can push into your repository in the normal Git fashion, and commit mails will be sent to the GNOME commits list.

Users without a git 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 2015-10-07 08:47:52 by SébastienWilmet)