> For the complete documentation index, see [llms.txt](https://docs.oobeya.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oobeya.io/integrations/all-integrations/scm-addons/gerrit-integration.md).

# Gerrit Integration

Learn about Gerrit & Oobeya integration.

This guide provides a step-by-step walkthrough to integrate your **Gerrit** code review system with **Oobeya** to track engineering metrics and DORA analytics.

***

### 1. Create Gerrit HTTP Credentials 🔑

To allow Oobeya to access your Gerrit repositories, you need to generate an HTTP access token.

1. **Access Settings:** Click the user icon in the top-right corner of your Gerrit UI, navigate to **Settings**.
2. **Generate Token:** Open the **"HTTP Credentials"** tab on the left sidebar and click the **"Generate New Password"** button.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2Fz2IpvfG94IG6miv3zkOW%2Fimage.png?alt=media&amp;token=17296043-053b-44f7-8707-d5f955ce912b" alt=""><figcaption></figcaption></figure>

3. **Secure Your Password:** Copy and save the generated password immediately. You will need this for the Oobeya data source configuration.

***

### 2. Install Gerrit Add-on on Oobeya 🧩

Before connecting your data, ensure the Gerrit integration is active in your Oobeya instance.

1. Log in to **Oobeya** with an **Administrator** account.
2. Navigate to **Integrations** from the side menu.
3. Locate the **Gerrit** add-on and click the **"Install"** button.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FSO4kJYo36b6HpAIBO2WX%2Fimage.png?alt=media&amp;token=18ad960a-0944-4e30-ba35-089ff8e39600" alt=""><figcaption></figcaption></figure>

***

### 3. Add A New Data Source 🔌

Now, connect your Gerrit server to start fetching data.

1. Navigate to **Data Sources** and select **Gerrit** from the SCM & CI/CD category.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F2nVHekSmJ0srUQkPQjEG%2Fimage.png?alt=media&amp;token=562e0b18-d4ee-4e63-9a83-e86743491003" alt=""><figcaption></figcaption></figure>

2. Click the **"New Data Source"** button and fill in the required fields:

* **Server URL:** Your Gerrit instance URL (e.g., `https://gerrit.yourdomain.com`).
* **Username:** Your Gerrit username.
* **Token:** The **HTTP Password** you generated in Step 1.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F0oURgmujjsOy2gsEtvTD%2Fimage.png?alt=media&amp;token=04c46646-40bf-4fcb-91be-ba5d832e01e1" alt=""><figcaption></figcaption></figure>

3. Click **"Test Connection"** to verify the credentials.
4. Once verified, click **"Add"** to finalize the setup.

***

### Ready to Connect 🚀

**Congratulations!** Oobeya is now connected to your Gerrit server. It will begin pulling real-time statistics from your repositories to track development velocity, code review cycles, and team performance.

## **Next Steps** :dart:&#x20;

* [Network Access Requirements ](/integrations/network-access-requirements.md)
* [Create a new Gitwiser Analysis](/gitwiser-repo-analytics/settings-for-git-analytics/initialize-development-analytics.md)