Collection of AWS setup scripts for setting up Gerrit Code Review

Clone this repo:
  1. 38fda67 Allow to specify global projects. by Marcin Czech · 12 days ago master
  2. 8291211 Add recipe to set up geo-location routing by Antonio Barone · 11 days ago
  3. 4bed1c9 Fix metrics exclusion indentation by Marcin Czech · 11 days ago
  4. 6af0bc6 Trim potential trailing newlines from secrets by Antonio Barone · 12 days ago
  5. 466e9d2 Use /bin/bash shell instead /bin/sh for make by Marcin Czech · 2 weeks ago

Gerrit AWS Templates

Those are a collection of AWS CloudFormation templates and scripts to deploy Gerrit in AWS.

The aim is to provide some guidelines and example on how to deploy different Gerrit setups in the Cloud using AWS as provider.



The goal of Gerrit AWS Templates is to provide fully-functional Gerrit installations to helps users deploying Gerrit on AWS by providing out-of-the-box templates.

With Gerrit AWS Templates, developers and administrator can create a production-ready installation on the cloud in minutes and in a repeatable way, allowing them to focus on fine tuning of the Gerrit configuration to suit the user needs.

The provided CloudFormation templates automate the entire creation and deployment of the infrastructure and the application.


To manage your AWS services via command line you will need to install AWS CLI and set it up to point to your account.

To build gerrit and related-components' images Docker


External services

This is a list of external services that you might need to setup your stack and some suggestions on how to easily create them.

SMTP Server

If you need to setup a SMTP service Amazon Simple Email Service can be used. Details how setup Amazon SES can be found here.

To correctly setup email notifications Gerrit requires ssl protocol on default port 465 to be enabled on SMTP Server. It is possible to setup Gerrit to talk to standard SMTP port 25 but by default all EC2 instances are blocking it. To enable port 25 please follow this link.

LDAP Server

If you need a testing LDAP server you can find details on how to easily create one in the LDAP folder.