# GitLab Integration

## 1. **Create GitLab Access Token**

1. Navigate to GitLab **Settings** and click the **"Access Tokens"** tab.
2. Select ***read*** permissions for the connection and click the **"Create personal access token"** button. 

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

3\. Copy and save the *access token* to use on the Oobeya data source connection.

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

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

![](https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FzASB8ouj2W7ul1hR2qws%2FScreenshot%202024-12-17%20at%2011.26.05.png?alt=media\&token=7220dbc5-22bb-49a0-9963-e967760946ee)

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

1\. Navigate to **Data Sources** and select GitLab to add a new data source. 

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

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

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

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

## **Ready to Connect** :rocket: 

Now Oobeya is connected with your own GitLab server to get the real-time statistics of your code repositories to track each development activity.

## **Next Steps** :dart: 

* [Add a new Widget](https://qa-dashboard.user.com/knowledge-base/articles/13/update/13/%7B%%20kb_article_url%2019%20%%7D)
* [Create a new Gitwiser Analysis](https://docs.oobeya.io/gitwiser-repo-analytics/settings-for-git-analytics/initialize-development-analytics)