> 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

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="/files/FAU2YsOFZH9nOOVEBSnf" 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="/files/r3Ih6mXqoDM0d2rC5pC1" 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="/files/NdKoGydmeTPsAiOpRmyZ" 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="/files/drXRc2DwOKwBnu3qUUCY" 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)