Gerrit 2.14

Download: 2.14

Documentation: 2.14

Release Highlights

  • Changes can be assigned to specific users
  • Open and Abandoned changes can be deleted
  • HTML emails and new templating framework
  • Support for receiving review comments by email
  • New Polymer based user interface
  • Support for elliptic curve/ed25519 SSH keys
  • Secondary index with Elastic Search (experimental)

Important Notes

Schema Changes

This release contains schema changes. To upgrade:

  java -jar gerrit.war init -d site_path

Java 8

Gerrit now requires Java Runtime Environment (JRE) version 8. It is no longer possible to run Gerrit on JRE 7.

Bouncy Castle Libraries

The Bouncy Castle Crypto API libraries are now distributed in the Gerrit .war file rather than being downloaded during site initialization. When upgrading from a previous version of Gerrit, previously downloaded Bouncy Castle .jar files remaining in the site's /lib folder will be disabled by appending .disabled to the file name.

HTTP Digest Authentication Removed

Support for HTTP Digest Authentiation is removed.

With the move to NoteDB, the per-account data (including the HTTP password) will be stored in a branch in the All-Users repo, where it is subject to Gerrit ACLs. Since these are notoriously hard to setup correctly, we want to avoid storing the password in plaintext.

Existing passwords will be migrated to a hashed password during site initialization when upgrading from an earlier version of Gerrit.

Deprecation of Velocity Email Templates

This release deprecates the use of Velocity mail templates. In a future release support will be removed and it will be necessary to upgrade custom mail templates to Soy files.

Tag Permissions

The permissions “Push Annotated Tag” and “Push Signed Tag” are renamed to “Create Annotated Tag” and “Create Signed Tag”. Existing project configurations using the old permission names will be migrated during site initialization.

New Features

Change Assignee

Changes may be assigned to a specific user. This allows a workflow where the user that is assigned to a change is responsible for reviewing the change and/or passing the assignment on to another user.

In the UI, changes assigned to the currently logged in user are highlighted.

A new assignee: search predicate allows to find changes assigned to a given user.

Delete Changes


HTML Emails

Gerrit email messages are made easier to read by sending HTML content parts in addition to the existing text email content. This is enabled by default, and can be disabled by setting sendemail.html to false.

Users can opt to always receive plaintext emails by setting the Email Format preference.

Closure Templates

Mail templates can now be written using Closure Templates (Soy). Mail templates written in Velocity (VTL) are deprecated but still supported. Support for VTL will be dropped in the next release.

Review Comments by Email

Gerrit now supports receiving review comments by email.

Secondary Index with Elastic Search

It is possible to enable Elastic Search as a secondary index by setting index.type to ELASTICSEARCH and configuring the Elastic Search specific configuration parameters.

Note that the Elastic Search implementation is still considered experimental and it is not advised to use it for production systems.

User Interface

  • Tags can be created and deleted via the Tags screen in the UI.

  • For merge commits, the list of commits that will be merged into the destination branch is included as the /MERGE_LIST magic file which is shown as Merge List in the UI.







New User Interface (“PolyGerrit”)

Gerrit now includes a new user interface, referred to as “PolyGerrit”, based on Polymer.

The UI can be switched between PolyGerrit and GWT by clicking the “New UI” and “Old UI” links in the site footer. Alternatively, the UI can be switched by adding ?polygerrit=1 or ?polygerrit=0 to the URL.

Note that PolyGerrit is still under development. Most use cases are supported, but there are still some missing features compared to the GWT UI.


  • Issue 4507: Add support for elliptic curve/ed25519 SSH keys.


Dependency Updates

  • Update auto-value to 1.4

  • Update Bouncy Castle to 1.56

  • Update codemirror to 5.25.0

  • Update commons-compress to 1.12

  • Update Guava to 21.0

  • Update Guice to 4.1.0

  • Update GWT to 2.8.0

  • Update gwtjsonrpc to 1.11

  • Update gwtorm to 1.17

  • Update JavaEWAH to 1.1.6

  • Update JGit to

  • Update jsch to 0.54

  • Update Lucene to 5.5.2

  • Update mina to 2.0.16

  • Update ow2-asm to 5.1

  • Update prolog-cafe to 1.4.2

  • Update SSHD to 1.4.0

Bugfix Releases

2.14.1 (In development)

  • Allow multiple Servlet filters on Jetty HTTPD.

    It is now possible to specify multiple values for httpd.filterClass.

  • Add a group indexed extension point.

    Similar to the existing change indexed and account indexed extension points, this allows plugins to be notified when a group has been indexed.

  • Fix support for ECDSA and ED25519 SSH keys.

    ECDSA and ED25519 SSH host keys were not generated during site initialization and were not loaded if they existed.

  • Fix initialization failure when removing old Bouncy Castle library fails.

    During initialization, old Bouncy Castle libraries are renamed with a .backup suffix, but if the destination file already existed the initialization would fail with a fatal error. Now a warning is printed and the initialization continues.

  • Issue 5393: Improve the performance of reviewer suggestion.

  • Issue 6173: Fix setting sshd.idleTimeout for nio2 backend.

    The idle timeout was not properly set for the nio2 backend, so connections would always time out with the default value (10 minutes).

  • Fix ref visibility checks in dashboards.

  • Replication plugin: Fix replication retries when maxRetries is set to 0.

  • Fix autocomplete for Firefox on LDAP login screen.

  • Add support for mariadb in AccountPatchReviewStore.

  • Fix notifications for comments on draft patch sets.

  • Fix internal server error when deleting current patch set and previous patch set doesn't exist.

  • Always use SSL implicitly for POP3 and IMAP.

    If receiveemail.encryption is set to TLS/SSL, we always want to use the implicit mode to execute the TLS/SSL command right after establishing the conection with the mail server. Strict mail servers like Gmail would close the connection prematurely otherwise.

  • PolyGerrit UI

    • Issue 6096: Add an “up” button to the diff screen.

    • Issue 6041: Display /MERGE_LIST and /COMMIT_MESSAGE as Merge List and Commit Message.

    • Issue 6080: Allow editing status when full name is not editable.

    • Issue 6176: Fix internal server error when old patch set is not found.