# 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.&#x20;

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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xygeni.io/getting-started/quick-start-with-your-code-repository.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
