Creating a new git repository
Creating a new git repository in git.gnome.org involves several steps. Depending on whether you already have a gnome.org git account or not, the instructions differ.
Users with a gnome.org 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 gnome.org.
1. Creating the repository
ssh <username>@git.gnome.org 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 http://git.gnome.org/browse/ 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>@git.gnome.org/git/<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 http://git.gnome.org/browse/<repository-name>.)
3. Finishing the import
Once you are satisfied, finish the import process by running:
ssh <username>@git.gnome.org 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 gnome.org 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: