Skip to end of metadata
Go to start of metadata

TeamCity integration with SonarQube is implemented via the open-source SonarQube plugin for TeamCity.

The plugin provides a simple user interface for configuring connection between TeamCity and SonarQube servers, and allows you to trigger analysis using the SonarQube Runner as a build step in TeamCity.

When the analysis is completed, the results are automatically published to the SonarQube server.

This page explains how to configure and use TeamCity integration with SonarQube.

On this page:

Installing Plugin

Download the plugin from the public TeamCity server and install it as described here.

After the SonarQube Runner plugin is installed, the SonarQube Servers page appears in the project settings and the SonarQube Runner is added to the list of the available runners for a Build Step.

(info) TeamCity 8.1 or greater is supported

Configuring SonarQube Server Connection

To enable the integration, you need to create at least one connection to a SonarQube Server. The connection will be used by TeamCity to send data to the SonarQube Server.

SonarQube Servers connections are managed in the SonarQube Servers page of the Project Settings, where the SonarQube server name and URL as well as the database settings are specified.
(info) For details on the database settings, see the SonarQube documentation. Example settings for different databases can be found here.

The connection defined in a project will be available to all its build configurations and subprojects.

Configuring SonarQube Build Step

After the integration is enabled, you can add and configure the SonarQube Build Runner as the final step of the build you want to run analysis on.
(info) Triggerring the analysis with Maven is not directly supported. To use the SonarQube runner with a Maven project, add the sonar:sonar goal to your project. See SonarQube documentation for detals.

In the runner settings, you need to select a connection to the server to send the data to. Other fields are to be configured as described in the SonarQube Runner documentation. are partially supported.

It is also recommended to provide paths to directories containing your sources root, test root, and binaries.

You can add more parameters for the SonarQube Runner in the "Additional parameters" field of the Advanced Options.

The plugin will trigger the SonarQube analysis with a SonarQube Runner and publish the results to the SonarQube server.

Viewing analysis results

Once the build is finished, the View in sonar link appears on the Build Results page allowing you to navigate to the SonarQube dashboard to view the results of the analysis.
(info)SonarQube Build Breaker is supported by the TeamCity plugin: the Build Breaker messages are parsed by TeamCity and added as Build Problems.

Configuring SonarQube Runner with:

ReSharper inspections (Inspections (.NET) runner)


  1. Add /\inspectReport.xml to the 'Additional inspectCode.exe arguments'
  2. In SonarQube Runner step, add the following to the  'Additional parameters' field:


dotCover results


  1. Hi,

    I'm just curious: when SonarQube plugin will be published as Maven Release instead of SNAPSHOT version currently available for download from public TeamCity server? I would prefer to install the stable version but not a development one.


    Nick Sorokin 

  2. this plugin is not updating my sonarqube with nunit/dotcover results, how do i do that?

    1. The main problem is to make nunit and dotcover running under TeamCity generate report files which could be recognized by SonarQube runner. Try to refer this post: Please ask me any questions if you'll have problems (better on In the meantime I'll make a new wiki page describing your case.

  3. Why does teamcity need direct access to the SonarQube database?  That doesn't seem right to me.

    1. TeamCity supports legacy SonarQube Runner which used direct access. Current SonarQube Scanner uses other scheme to publish data so database config is not mandatory. 

  4. Hi,


    The plugin supports MSBuild Runner for SonarQube?

    Since it is necessary to Start the MSBuild Runner before the build and then stop it afterwards (when done manually) it is not clear whether or not this actually supports that since it explicitly says to be put at the end of the build process.



    1. Currently this plugin doesn't support SonarQube MSBuild Runner. You can still try using this plugin (some functionality can be inaccessible) or use TC command line runner to manually start and finish the SQ Runner. 

  5. I am using Jacoco Coverage runner in my TeamCity Gradle build step. In the next step I have SonarQube runner, but I don't know where the coverage report in the previous step gets stored ( I have no access to TeamCity build agent at my company ) so I wonder where the default location is so I can point -Dsonar.jacoco.reportPaths to it?

    Also, what about IntelliJ coverage runner? how should I feed the report to the next step (SonarQube runner)? Thank you

    1. Actually SonarQube Plugin should autodiscover jacoco coverage file and pass needed properties to the Scanner like this:
      Did you provide "Binaries location" in the SonarQube Runner step? 
      1. Yes, it works now. Thank you!

  6. It looks like SonarQube Runner don't read sonar properties in pom.xml.  We need add additional parameters  in SonarQube runner step to make it work. Does it work as design? Will it be improved in the future?

    1. You can pass any additional properties through Additional Parameters field or through file (see

  7. Can this plugin run/support analysis for javascript (ReactJs) based project with SonarQube ?

    1. The plugin just provides UI to configure analysis and runs SonarQube Scanner on agent. So if the Scanner supports ReactJs then the TeamCity SonarQube Plugin does.