> 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/jenkins-integration.md).

# Jenkins & Cloudbees Integration

## 1. **Generate Jenkins API Token**

1\. On Jenkins, open the user dropdown on the top bar and click the **"Configure"** option. 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FRpUUtJglGgD0w5drncf8%2Ffile.png?alt=media)

2\. Generate a new API Token.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FhgatmT8quxOjzTYTzNjX%2Ffile.png?alt=media)

3\. Copy and save the *API Token* to use on the Oobeya data source connection.

## **2. Install Jenkins Addon on Oobeya** :jigsaw: 

1. Log in to [Oobeya](https://oobeya.io/) with an *Administrator* account.
2. Navigate to **Integrations**, select the Jenkins addon, and click the **"Install"** button. 

<figure><img src="/files/H7fl5lQAawXyF4QNtPOg" alt=""><figcaption></figcaption></figure>

## **3. Add A New Data Source** :electric\_plug:&#x20;

1\. Navigate to **Data Sources**, and select Jenkins to add a new data source.&#x20;

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FlPEJ9ZdExRIcbNRLGeMm%2Ffile.png?alt=media)

2\. Click the **"New Data Source"** button and fill in the form by using the *API Token* which was created on Jenkins settings in the first step.&#x20;

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2Fv3pOYb7pNqJpxTsUF88b%2Ffile.png?alt=media)

3\. Click the **"Test Connection"** button to verify the connection.

## **Ready to Connect** :rocket:&#x20;

Now Oobeya is connected with your own Jenkins server to monitor the health status of your pipelines and track key metrics such as *time-to-fix, average deployment duration...*

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

* [Add a new Widget](/dashboards/adding-a-new-widget.md)