> 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/github-integrations.md).

# GitHub Integration

There four options to integrate [Oobeya](https://oobeya.io) with [GitHub](https://github.com). 

1. **Option 1:** [Use a Personal Access Token](#id-1.-generate-github-personal-access-token)
2. **Option 2:** [Use the official Oobeya GitHub App from the GitHub Marketplace. ](/integrations/all-integrations/scm-addons/step-by-step-integration-instructions-for-the-oobeya-github-application.md#option-1-using-the-official-oobeya-github-app)
3. **Option 3:** [Register your own GitHub application.](/integrations/all-integrations/scm-addons/step-by-step-integration-instructions-for-the-oobeya-github-application.md#option-2-registering-your-own-github-application)
4. **Option 4:** [Use a GitHub App Installation Token](/integrations/all-integrations/scm-addons/step-by-step-integration-instructions-for-the-oobeya-github-application.md#option-3-using-a-github-app-installation-token)

***

## 1. G**enerate GitHub Personal Access Token**

1. Navigate to GitHub **Settings** and click the **"Developer Settings"** tab.
2. Select the **"Personal access tokens"** tab, **"Tokens (classic)"**, **"Generate new token"** and **"Generate new token (classic)"** button. Select ***read*** permissions for the connection.

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

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

&#x20; 3\. Copy and save the ***access token*** to use it on the Oobeya data source connection.

## **2. Install GitHub Addon on Oobeya** :jigsaw:&#x20;

1. Log in to Oobeya with an *Administrator* account.
2. Navigate to **Integrations** and select the **GitHub** addon. Then click the **"Install"** button.

![](/files/8tFIZOuRoIGh3DX47sgr)

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

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

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

2\. Click the **"New Data Source"** button and fill in the form using the *Access Token* created on GitHub settings in the first step.

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

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

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

Following these steps, you can integrate the Oobeya seamlessly with your GitHub account, enhancing your development workflow with insightful metrics and data such as [DORA metrics](https://oobeya.io/dora-metrics-four-key/) and [pull request metrics](https://oobeya.io/oobeya-metric-definitions/).

## **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)