# Changing your project binding

You must be an administrator of your project.

## Unbinding or changing the binding of a bound project

1. Retrieve your project. For more information, see [Retrieving projects](/sonarqube-server/2026.2/user-guide/viewing-projects/retrieving-projects.md).
2. Go to **Project Settings** > **General Settings** > **DevOps Platform Integration**.
3. In the bottom of the page, select **Reset**. The project is unbound.
4. To bind the project to another repository, see [#binding-an-unbound-project](#binding-an-unbound-project "mention") below.

## **Binding an unbound project**

If you created your project manually and want to bind it to its DevOps platform repository to benefit the features of a bound project, proceed as follows:

1. Retrieve your project in SonarQube Server. For more information, see [Retrieving projects](/sonarqube-server/2026.2/user-guide/viewing-projects/retrieving-projects.md).
2. Select **Bind project** from the project Overview page. The DevOps Platform Integration page opens.

<figure><img src="/spaces/KXW79zfYFiA8incTvwZK/files/RRLa1nm2q05TNwhbTRBJ" alt="Select bind project from the project overview page."><figcaption></figcaption></figure>

3. In **Configuration name**, enter the Configuration record used to manage your DevOps platform integration at the global level. Ask your system administrator.
4. This step depends on your DevOps platform:
   * GitHub: In **Repository name**, enter the name of the GitHub repository you want to bind.\
     You can enable the [analysis summary under the GitHub Conversation tab](https://docs.sonarsource.com/sonarqube-server/user-guide/issues/in-devops-platform/github#pull-request-decoration).
   * Bitbucket Cloud: In **Repository slug**, enter the URL of the Bitbucket Cloud repository you want to bind.
   * GitLab: In **Project ID**, enter the unique identifier of your GitLab project you want to bind.
   * Azure DevOps:
     * In **Project name**, enter the name of the Azure DevOps project containing your repository.
     * In **Repository name**, enter the name of the Azure DevOps repository you want to bind.
     * By default, [pull request annotations](https://docs.sonarsource.com/sonarqube-server/user-guide/issues/in-devops-platform/azure-devops#pull-request-decoration) are enabled. You can disable them.
5. Select **Save configuration**. The new binding is saved.
6. Select **Check configuration**. SonarQube Server checks if the entered DevOps platform repository exists and you have access to it.

{% hint style="info" %}
The project binding (incl. the configuration check) is logged in the [audit logs](/sonarqube-server/2026.2/instance-administration/security/audit-logs.md).
{% 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.sonarsource.com/sonarqube-server/2026.2/project-administration/maintaining-project/changing-project-binding.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.