ITK/Git/Account

This page documents how to setup ITK developer accounts. See our table of contents for more information.

Note: Google is currently dropping support for OpenID authentification through Google accounts.
While currently registered Gerrit users can still use their account, new Gerrit account
registrations with Google currently face the error: 
  400. That's an error. OpenID auth request contains an unregistered domain.

We are currently upgrading the Gerrit infrastructure, and GitHub-based authentifications will soon
be possible. Until that time, it is suggested that new Gerrit accounts made with a Yahoo account.  

Gerrit

Anyone may request access to the ITK Gerrit Code Review site to propose and review changes. Follow these steps to set up access:

1. Get an OpenID
2. Register at http://review.source.kitware.com using your OpenID (link in upper right)
3. Sign in
4. Set all fields in your profile at http://review.source.kitware.com/#settings
5. Add your ssh public key at http://review.source.kitware.com/#settings,ssh-keys

Firewall blocks SSH traffic

If you are stuck behind a firewall that blocks SSH traffic (port 22), the following alternative URL may be used to push patches over HTTP (port 80):

1. For Gerrit user bob: $ git config --global url.http://bob@review.source.kitware.com/p/ITK.insteadOf bob@review.source.kitware.com:ITK
2. Generate a password at http://review.source.kitware.com/#/settings/http-password
3. A password prompt will be presented when pushing patches to Gerrit.

This requires Git 1.6.6 or newer.

Git

Authorized community members may merge patches to the itk.org repositories, but most community members do not need merge permissions. All patches from all community members go through Gerrit Code Review, and patches will be merged by one of the maintainers after it has been reviewed.

Follow these steps to set up access:

1. Submit your ssh public key to the Kitware Password form
2. Perform an authentication test:

   $ ssh git@itk.org info