# Quick start with your code repository

## Creating an Integration with your SCM

Xygeni provides a quick way to scan your repositories directly from the UI. With this functionality ([**Managed Scans**](https://docs.xygeni.io/scan-management/managed-scans)) you will be able to scan your repos and Xygeni will manage everything behind the scenes. 

First, go to **Home >>** **Managed Scans**

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2F4KPYSl8B5LIqZYuGdeVb%2Fimage.png?alt=media&#x26;token=d6cb78a9-cc59-452a-9483-4ad0801d1efd" alt=""><figcaption></figcaption></figure>

Click on **Add Repository** button to create an integration with your **SCM**. A dialog will open to select your SCM:

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FQNsQu8mPAj9FgOc8oFCZ%2FScreenshot%202025-04-04%20105258.png?alt=media&#x26;token=aeff408b-ac6f-4bb9-8803-8246f9c88d67" alt=""><figcaption></figcaption></figure>

For this example, we will use GitHub. So clicking on GitHub will install **Xygeni GitHub Application.**&#x20;

As you can see below, the installation procedure will let you specify the scope of the installation (user- or organization-level)

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FwPUqE4InXdB6xMoFR6wv%2Fimage.png?alt=media&#x26;token=2cf2717b-acc3-41a4-9406-cd479ce5b7f9" alt="" width="349"><figcaption></figcaption></figure>

The installation will ask you to grant permission to **Xygeni GitHub Application** to all or only selected repositories.

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FeqYYlvJYddm8PNOgxEWs%2Fimage.png?alt=media&#x26;token=d9c70898-dd62-4f3e-a70b-897dbea651de" alt="" width="320"><figcaption></figcaption></figure>

After clicking on **Install & Authorize** button, the Managed Scans page will display the new integration.

It also display a table listing the granted repositories (this list depends on previous step).

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FGTGF6lFIgZL59pB94jJI%2FScreenshot%202025-04-04%20105058.png?alt=media&#x26;token=0cbf7f65-f965-4784-8840-c9ae70fa3e53" alt=""><figcaption></figcaption></figure>

Clicking on the **Scan Now** button of any repo will execute a scan on that repo.

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FiSRF8bAIrPyuVKAm4toh%2FScreenshot%202025-04-04%20123426.png?alt=media&#x26;token=a343ccb8-823b-43d6-8386-5365635fc9b6" alt=""><figcaption></figcaption></figure>

If you go now to GitHub, you will see a workflow running the scan:

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FbduBzx4ymsAZSMUxGCHF%2Fimage.png?alt=media&#x26;token=f3b06634-227f-4e44-abf6-8eebb597cfee" alt=""><figcaption></figcaption></figure>

**That's all!!**

After the scan is completed, you **can find the results** in the [**Dashboard**](https://docs.xygeni.io/introduction-to-xygeni/xygeni-web-ui-overview/dashboard). The name of your project will be the same as your repository name.

You can also configure to be **notified** when the scan is **finished**. See [Notifications](https://docs.xygeni.io/xygeni-administration/platform-administration/notifications).&#x20;

{% hint style="info" %}
Please, visit [**Managed Scans**](https://docs.xygeni.io/scan-management/managed-scans) for other available options such as  scheduling a scan or trigger the scan upon Pull Request creation.&#x20;
{% endhint %}