Gerrit credentials setup (for Chromium OS and Chrome OS)


If you want gerrit access for non-Chromium OS/Chrome OS projects, please use the old instructions here

We have two gerrit instances: Chromium OS and the (internal) Chrome OS gerrit instance.

For the Chromium OS instance: This is where most of the development happens. You do not have to be an "official" Chromium contributor or Googler or anything else to interact with the Chromium OS gerrit instance and/or upload changes to it.  We restrict access by only allowing certain people to approve changes before they're allowed to go into the main tree.  

For the internal Chrome OS instance: Access is restricted to Googlers.

The gerrit instance for Chromium OS and Chrome OS uses Google Accounts to provide authentication. This means any account you can use to log into can also be used to authenticate with Gerrit.

(EVERYONE) To get access to the Chromium OS gerrit instance:

  1. Go to
  2. Log in with the email you use for your git commits.
    1. If you are a Googler, use your account.
    2. You can verify this by ensuring that the Username field looks like git-<user>
  3. Follow the directions on the new-password page to set up/append to your .gitcookies file.
    1. You should click the radio button labeled "only" if it exists.
  4. Verification: Run git ls-remote
    1. This should not prompt for any credentials, and should just print out a list of git references.
  5. Make sure to set your real name.
    1. Visit and check the "Full Name" field.
    2. If it isn't set, you will need to update your Google+ profile.
    3. Once your Google+ profile is up-to-date, you might have to logout/login in Gerrit.

(Googler) To get access to the internal Chrome OS gerrit instance:

  1. You must also do the steps above for your @chromium account first
  2. Go to and verify you are logged into your account
  3. In the same window and session, load
    1. Make sure you are logged into your account. 
    2. You can verify this by ensuring that the Username field looks like git-<user>
  4. Follow the directions on the new-password page to append to your .gitcookies file. You should click the radio button labeled "only" if it exists.
  5. Verification: Run git ls-remote
    1. This should not prompt for any credentials, and should just print out a list of git references.
  6. Make sure to join the chromeos-team mailing list. This enables access to things like trybots. 

For more non-chromium-specific info on using repo to interact with gerrit, read Android's Git Workflow using repo/gerrit and life of a patch.

(Googler) Link & accounts

We use memberships of identities in particular groups to control access to Chrome OS repositories on chromium-review and chrome-internal-review sites. Since you will be primarily using account, you need to tell Gerrit that your and accounts are linked together. Follow the steps:
  1. Login into using your account.
  2. If you are using the new UI (should be the default for new accounts):
    1. Click on the circle with your profile picture on the top-right of the page, then choose Settings -> Email Addresses.
    2. Enter your email address in the New email address field and click the Send Verification button. In your mail, click the confirmation link.
    3. Open Settings -> Email Addresses again and confirm that you have and addresses listed.
  3. If you are using the old UI:
    1. Go to Settings -> Contact Information.
    2. Click "Register new email...", enter your account and follow the instructions.
    3. To verify that it worked, open Settings -> Identities and verify your, and ldapuser/* identities are listed.
  4. Repeat the previous steps on, but use your email to login, and in "Register new email" dialog.
  5. If you see any errors during this process, file Infra-Git ticket with the subject "Link my <id> and <id> accounts". If it is urgent, add to CC on the ticket. Otherwise, the request should be handled within 2-3 days.
Once your accounts are linked, you'll be able to use both and emails in git commits. It is particularly useful if you have your email in global git config, and you try to trigger chrome-internal trybots (that otherwise require email). 

Uploading your changes for review

You can use "repo upload . --cbr" (instead of "git cl upload").  Use "repo help" for options on adding reviewers and CC'ing developers from the command line.  You can do this from the Gerrit web interface too once you upload the change.

More documentation on Uploading changes for review.

Watching Projects

You can select Projects (and branches) you want to "watch" for any changes on by adding the Project under Account Settings --> Watched Projects

Please feel free to add/modify any other Gerrit related information you think may be useful for other developers here.

Not getting email?

In case you think you should be receiving email from Gerrit but don't see it in your inbox, be sure to check your spam folder.  It's possible that your mail reader is mis-classifying email from Gerrit as spam.

Still having a problem?

Check out the Gerrit Documentation to see if there are hints in there.

If you have any problems please open a Build Infrastructure issue on the Chromium issue tracker (the "Build Infrastructure" template should be automatically selected).