Skip to main content
Version: TeamForge 25.1

Set up Gerrit Plugins

The TeamForge-Git integration bundles the following additional Gerrit plugins:

  • AI Code Review - Uses AI to automatically review code changes submitted to Gerrit.
  • Reviewers - Automatically adds default or suggested reviewers to Gerrit changes.
  • Slack Integration - Publishes Gerrit events (new changes, comments, merges, etc.) to a Slack channel.

These plugins ship as JAR files inside gerrit.war but are not active by default. Follow the setup instructions for each plugin to extract, install, and configure them.

Common Prerequisites​

  • TeamForge-Git integration is installed and running.
  • SSH access to the Gerrit server on port 29418.
  • Site administrator or root access to the Gerrit host.

General Installation Steps​

While each plugin has its own configuration, the installation workflow is similar:

  1. Extract the plugin JAR from gerrit.war:

    cd /opt/collabnet/gerrit/bin
    mkdir /tmp/unzipped && unzip -q gerrit.war -d /tmp/unzipped

  2. Copy the plugin JAR to the Gerrit plugins directory:

    cd /tmp/unzipped/WEB-INF/plugins
    cp <plugin-name>.jar /opt/collabnet/gerrit/plugins/

  3. Restart Gerrit:

    teamforge restart -s gerrit

  4. Verify the plugin is loaded:

    ssh -p 29418 <username>@<gerrit-host> gerrit plugin ls

  5. Reload a plugin without restarting Gerrit (optional):

    ssh -p 29418 <username>@<gerrit-host> gerrit plugin reload <plugin-name>

See the individual plugin pages for detailed configuration instructions.