This guide was made with the impatient in mind, ready to try out Gerrit on their
own server but not prepared to make the full installation procedure yet.

Explanation is sparse and you should not use a server installed this way in a
live setup, this is made with proof of concept activities in mind.

It is presumed you install it on a Unix based server such as any of the Linux
flavors or BSD.

It’s also presumed that you have access to an OpenID enabled email address.
Examples of OpenID enable email providers are Gmail, Yahoo! Mail and Hotmail.
It’s also possible to register a custom email address with OpenID, but that is
outside the scope of this quick installation guide. For testing purposes one of
the above providers should be fine. Please note that network access to the
OpenID provider you choose is necessary for both you and your Gerrit instance.
OpenID provider you choose is necessary for both you and your Gerrit instance.

Requirements

Most distributions come with Java today. Do you already have Java installed?

Refer to the Gerrit configuration guide for more detailed information about
authentication and
proxy settings.

The first user to sign-in and register an account will be
automatically placed into the fully privileged Administrators group,
permitting server management over the web and over SSH. Subsequent
users will be automatically registered as unprivileged users.

Once signed in as your user, you find a little wizard to get you started.
The wizard helps you fill out:

Real name (visible name in Gerrit)

Register your email (it must be confirmed later)

Select a username with which to communicate with Gerrit over ssh+git

The server will ask you for an RSA public key.
That’s the key we generated above, and it’s time to make sure that Gerrit knows
about our new key and can identify us by it.

Project creation

Your base Gerrit server is now running and you have a user that’s ready
to interact with it. You now have two options, either you create a new
test project to work with or you already have a git with history that
you would like to import into Gerrit and try out code review on.

New project from scratch

If you choose to create a new repository from scratch, it’s easier for
you to create a project with an initial commit in it. That way first
time setup between client and server is easier.

You need to make sure that at least initially your account is granted
"Create Reference" privileges for the refs/heads/* reference.
This is done via the web interface in the Admin/Projects/Access page
that correspond to your project.

Usually when you push to a remote git, you push to the reference
'/refs/heads/branch', but when working with Gerrit you have to push to a
virtual branch representing "code review before submission to branch".
This virtual name space is known as /refs/for/<branch>

Quick Installation Complete

This covers the scope of getting Gerrit started and your first change uploaded.
It doesn’t give any clue as to how the review workflow works, please read
Default Workflow to
learn more about the workflow of Gerrit.