For Developers‎ > ‎

Gerrit Guide


(EVERYONE) To get access to the Chromium 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. Run cd src && git config --local true` to default to uploading your reviews to Gerrit
    1. 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) Link & accounts

    We use memberships of identities in particular groups to control access to Chromium 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. Go to Settings -> Email Addresses.
    3. Click "Register new email...", enter your account and follow the instructions.
    4. To verify that it worked, open Settings -> Identities and verify your, and ldapuser/* identities are listed.
    5. Repeat 1-4 on, but use your email to login, and in "Register new email" dialog.
    6. 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). 

    How do I build on other ongoing Gerrit reviews?

    Scenario: You have an ongoing Gerrit review, with issue number 123456 (this is the number after the last / in the URL for your Gerrit review). You have a local branch, with your change, say 2a40ae.

    Someone else has an ongoing Gerrit review, with issue number 456789. You want to build on this. Here’s one way to do it:

    git checkout -b their_branch
    git cl patch -f 123456
    git checkout -b my_branch # yes, create a new
    git cherry-pick 2a40ae # your change from local branch
    git branch --set-upstream-to=their_branch
    git rebase
    git cl issue  123456
    <any more changes to your commit(s)>
    git cl upload

    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).

    For additional information, you can also visit the PolyGerrit + Chromium FAQ.