Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 80 Next »

Table of Contents

The Sonar Runner is recommended as the default launcher to analyze a project with Sonar.


You must have previously installed the Sonar Runner and read Analyzing Code Source.


Simple Project

A file must be created in the root directory of the project:

Then the command 'sonar-runner' must be executed from the project base directory to launch the Sonar analysis. That's it!

Multi-module Project


Advanced Usage

If a file cannot be created in the root directory of the project, there are several alternatives:

  • The properties can be specified directly through the command line. Ex:

  • The property 'project.settings' can be used to specify the path to the project configuration file (this option is incompatible with the 'project.home' property). Ex:


The Sonar working directory can be set through the '' property (default is '.sonar').

The root folder of the project to analyze can be set through the 'project.home' property. This folder must contain a file if the mandatory properties (like 'sonar.projectKey') are not specified on the command line.

Additional analysis parameters can be defined in this project configuration file or through command-line parameters. 


If you get an java.lang.OutOfMemoryError, you can set the SONAR_RUNNER_OPTS environment variable, like this in *nix environments:

On Windows environments, avoid the double-quotes, since they get misinterpreted, turning the two parameters into a single one.

Sample Project

To help you getting started with the Sonar Runner, a list of sample projects is available on github that can be browsed or downloaded: projects/languages/java/sonar-runner

  • No labels