This version of the SonarQube documentation is no longer maintained. It relates to a version of SonarQube that is not active.

See latest version
Start Free
9.8 | User guide | Applications

Was this page helpful?


On this page

Applications are available starting in Developer Edition.

Using applications

An application aggregates multiple projects into a synthetic single project. Assume that you have a set of projects which have been split for technical reasons, but which share a life cycle; they interact directly in production and are always released together. With an application, they can be treated as a single entity in SonarQube with a unified project homepage, issues list, measures space, and most importantly, pass through the same quality gate.

Applications vs. portfolios

Applications and portfolios are both aggregations of projects but have different goals and therefore different presentations. A portfolio is designed to provide a very high-level, executive overview that gives a perspective on quality between what may be only tangentially related projects. Applications allow you to see your set of projects as a larger, overall meta-project. For instance, because all the projects in an application ship together, if one of them isn't releasable, then none of them are, and an Application's consolidated quality gate gives you an immediate summary of what must be fixed across all projects in order to allow you to release the set.

Application setup

You can create an application by selecting Create Application in the upper-right corner of the Projects homepage.

Starting in Enterprise Edition, you can also create and edit applications in the global portfolio administration interface at Administration > Configuration > Portfolios.

For more information on setting up applications, see Managing applications.

Populating application data

An application is automatically re-calculated after each analysis of one of its projects. If you want immediate (re)calculation, anyone with Administration user rights on the application can use the Recompute button in the application-level Application Settings > Edit Definition interface.

Starting in Enterprise Edition, the global Portfolio administration interface, Administration > Configuration > Portfolios, offers the ability to queue the analysis of all Applications and Portfolios at once.

Applications and branch analysis

Branches are available for applications. They allow you to aggregate branches from the projects in an Application.

Note: To prevent issues with your Application status, avoid adding branches to your application that will be deleted.

Once an Application has been set up, anyone with Administration user rights on the application can manually create a new branch in the Application Settings > Edit Definition interface. In Enterprise Edition and above, you can also manage branches from the global Administration > Configuration > Portfolios interface. For each application branch, you can choose which project branch should be included or decide whether the project should be represented in the branch at all.

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

Creative Commons License