Install Free
Eclipse | Team features | Connected Mode

Connected Mode

On this page

Connecting SonarQube for IDE to SonarQube Server, SonarQube Cloud, or SonarQube Community Build is the first step in setting up the Sonar Solution, to take advantage of having consistent issues reported on both sides. Setting up connected mode will permit the transmission of information SonarQube for IDE needs, such as URLs and user credentials or file exclusions and marked issues, to communicate with SonarQube (Server, Cloud) or SonarQube Community Build. When binding your local workspace folder to your SonarQube (Server, Cloud) or SonarQube Community Build project(s), SonarQube for IDE will try to match, as much as possible, the same rules and settings as found on the server.

While in connected mode, SonarQube for IDE receives notifications from SonarQube (Server, Cloud) or SonarQube Community Build about your quality gate changes and new issues. Smart notifications can be enabled or disabled from the UI while creating or editing the connection settings. 

Benefits

Free and open-source versions of SonarQube Server and SonarQube Cloud are available to work in connected mode. In SonarCloud, it’s always free to analyze your publicly accessible projects; subscription plans are required only if linking to a private repository.

Prerequisites and supported languages

Having a SonarQube Server project (in an Active version) or a SonarQube Cloud project is required to run SonarQube for Eclipse in Connected Mode. The Rules and languages page has a complete overview outlining which additional rules are available when using Connected Mode.

Branch awareness

Branch awareness allows SonarQube for IDE to consider the branch currently checked out in the IDE and synchronize it with the most appropriate branch from the SonarQube (Server, Cloud) or SonarQube Community Build; we call this branch matching.

In Connected Mode, SonarQube for IDE synchronizes some data from the issues found on the server, such as the issue's status and resolution. It is important that SonarQube for IDE knows which branch the user is on at that moment to sync the local analysis with the correct branch analyzed by SonarQube (Server, Cloud) or SonarQube Community Build.

SonarQube for Eclipse only supports Git and the Git branch name with regard to branch matching; to do this, Eclipse’s relies on the EGit project. 

If there is no EGit, SonarQube considers that there is no source code management (SCM) provider. Some distributions for Java or Python, for example, come with packages of bundles preinstalled, but you can also install the needed components. 

In addition, your project must be under Git source control; simply installing EGit is not enough to take advantage of the Branch awareness feature. Git source control is necessary to avoid false expectations, for example, from some Cobol IDE users. See the EGit documentation for more information.

Checking which branches are analyzed on the server

In SonarQube Server, open the highlighted drop-down list shown below (as it looks in SonarQube Server) for a list of analyzed branches and pull requests.

A view of your analyzed branches and pull request in SonarQube.

To analyze branches other than master|main , please check the SonarQube Server or SonarQube Cloud documentation about branch analysis.

How SonarLint selects which branch to sync

SonarLint deploys these three methods to choose which branch (in SonarQube (Server, Cloud)) to sync with the local analysis.

Exact match

Branches with the same name are considered the same branch. If the branch that is currently checked out locally is analyzed on the server, SonarLint will pick this branch for synchronization. 

Closest branch

SonarQube for IDE will consider all local branches that also exist on the server. For each branch, SonarQube for IDE will compute the distance between the current HEAD and the branch by the count of commits. The closest branch will be kept. In case the number of commits is the same for two or more branches and the main branch is among them, it will be preferred; otherwise, the tie will be broken with a random choice (from the list of equidistance branches).

Default to main branch

All other cases will default to the branch marked as "main" on the server. For example, if there is an error in reading the branch, or if there is no Git repo, SonarQube for IDE will default to the main branch.

Long and short-lived branches

When using Connected Mode with SonarQube Cloud, issues on short-lived branches are not synchronized. When an issue is marked in SonarQube Cloud accepted or false positive on a short-lived branch, SonarQube for IDE will still show that issue in the IDE.

SonarQube Server does not distinguish between long- and short-lived branches therefore, all issue resolutions are recognized.

Connection setup

SonarQube for Eclipse provides a connection wizard to help you set up Connected Mode with SonarQube (Server, Cloud). Please see the Connected Mode setup page for detailed instructions to set up Connected Mode and bind your project.

Sharing your setup

From version 10.1, it is possible to share a setup configuration file with your team, simplifying the process. 

One team member must step through the first-time setup process, then export and commit the binding configuration to the repository. Any team member running SonarLint will find the binding details inside of the project’s source folder and automatically receive a notification to bind the project.

Please see the Connected Mode setup page for detailed instructions.

SonarLint-SonarQube version support policy

SonarQube for IDE enables users to establish a connection to the latest SonarQube Server version and to the latest LTA (Long-Term Active) version. When a new LTA version is released, we still enable connecting SonarQube for IDE to the previous LTA version for a certain period of time (currently 9 months after the latest LTA release) to allow enough time for organizations to upgrade their SonarQube Server version. 

For more information about long-term support of SonarQube Server, check out our page describing "what an LTA is" and, to review IDE-specific requirements, please check the respective pages of the documentation as listed in the next paragraph.

⚠️ The 8.9LTA reached its support expiration date (in November ’23).

Notifications

When you are using Connected Mode and connected to the server, you can be notified in your IDE with smart notifications as soon as something appears on the server that something failed, or when the Sonar Quality Profile is updated, for example. The notification will include a link to call back to SonarQube (Server, Cloud) where you can learn more about the issues that were introduced. Sonar Smart Notifications are available in all editions of SonarQube (Server, Cloud).

Connected mode allows SonarQube (Server, Cloud) and SonarQube Community Build to send smart alerts to individuals or teams as soon as something appears on the server that something failed, when new issues are discovered or when the Sonar Quality Profile is updated, for example. With everyone in the loop, issues can be addressed promptly, improving the overall software quality and delivery. The notification will include a link to call back to SonarQube (Server, Cloud) and SonarQube Community Build where you can learn more about the issues that were introduced. 

You'll receive smart notifications in your IDE when:

  • the quality gate status of a project open in your IDE changes (see the SonarQube Server, SonarQube Cloud, or SonarQube Community Build documentation for details about using quality gates in your project)
  • a SonarQube (Server, Cloud) and SonarQube Community Build analysis raises new issues that you've introduced in a project open in your IDE

You can activate or deactivate smart notifications in SonarQube for IDE on the IDE side for a server-by-server basis.

Sonar Smart Notifications are available in all editions of SonarQube (Server, Cloud) and SonarQube Community Build.

Activation and Deactivation of Sonar Smart Notifications occurs in the IDE during the binding process. To change your notification settings, go to the SonarLint Bindings view, right-click the connection you want to change, and select Edit Connections…


Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARQUBE, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License