Installing the scanner

This page includes information about installing the SonarScanner for .NET on SonarQube Cloud.

SonarScanner for .NET — 10.4.1.124928 | Issue Tracker

10.4.1.124928 ^_2025-09-23 ^{Fix a bug that erroneously warns that Community Build is not supported.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.4.0.124828 ^_2025-09-22 ^{New communication system with SonarQube.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.3.0.120579 ^_2025-07-16 ^{Support xUnit v3, fix RunDeploymentRoot in trx files, remove sonar.scanner.scanAll analysis warning.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.2.0.117568 ^_2025-06-03 ^{Fix a vulnerability from embedded scanner-cli.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.1.2.114627 ^_2025-04-16 ^{Add 'sonar' default truststore passord fallback.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.1.1.111189 ^_2025-03-25 ^{Maintenance and dependencies updates.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.1.0 ^_2025-03-19 ^{Maintenance and dependencies updates.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

10.0.0 ^_2025-03-13 ^{Fix a vulnerability. Mandate that the truststore password is passed in the end step if used in the begin step. Added support for 7 new languages.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

9.2.1 ^_2025-02-25 ^{DEPRECATED. Use system trusted certificate or JVM certificate store.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

9.2.0 ^_2025-02-19 ^{DEPRECATED. Support for local trust store for private and self-signed certificates.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

9.1.0 ^_2025-02-06 ^{Read new properties for downloading plugins} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

9.0.2 ^_2024-11-12 ^{sonar.projectBaseDir passed through extraProperties is respected with Azure DevOps extensions. Do not fail during file indexing when a directory cannot be accessed.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

9.0.1 ^_2024-10-25 ^{Fix projectBaseDir path detection on Azure DevOps Linux agents.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

9.0.0 ^_2024-09-27 ^{Ignore sonar.sources and sonar.tests properties.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

8.0.3 ^_2024-09-13 ^{Exclude XML files from the new automatic analysis. Do not crash on mlaformed paths. Make sure server-side exclusions are not overridden.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

8.0.2 ^_2024-09-02 ^{Re-enabled sonar.exclusions support. Automatically exclude files passed-in as coverage. Skip transient projects that do not exist after the build.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

8.0.1 ^_2024-08-21 ^{Bug fix release which addresses two issues, improvements on messages emmitted during the analysis.} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

8.0 ^_2024-08-12 ^{The scanner is now supporting multi-language analysis. Files for other languages are automatically picked up (SQL, YAML, XML, JSON, CSS, HTML, JS, TS)} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

7.1.1 ^_2024-07-24 ^{Fixed a small issue when not specifying sonar.host.url (defaults to https://sonarcloud.io)} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

7.1 ^_2024-07-19 ^{Fixed a small issue when not specifying sonar.host.url (defaults to https://sonarcloud.io)} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

7.0 ^_2024-07-18 ^{This version does not require a JRE to be present on the machine anymore} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

6.2 ^_2024-02-16 ^{Fixes the failing analysis on macOS with .NET 8.0. New optional sonar.http.timeout command line parameter} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

6.1 ^_2024-01-29 ^{Drop support for MSBuild 14, deprecate MSBuild 15} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

6.0 ^_2023-12-04 ^{Packaging change, drop support for .Net Framework 4.6, Net 2.1, and .Net 3.0. Drop Java 11 support. Drop support of SonarQube versions prior to 8.9} Download scanner for: .NET Global Tool .NET Core 3.1+ .NET Framework 4.6.2+ Release notes

5.15.1 ^_2024-03-26 ^{Fix analysis on MacOSX with .NET 8 when begin runtime doesn't match with build runtime} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.15 ^_2023-11-20 ^{Add an option to specify the scanner's temporary working directory} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.14 ^_2023-10-02 ^{Support upcoming SonarQube 10.4 API changes} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.13.1 ^_2023-08-14 ^{SonarScanner CLI update} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.13 ^_2023-04-05 ^{Support for sonar.token parameter and improved error messages} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.12 ^_2023-03-17 ^{Fast PR Analysis Support For Azure Devops} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.11 ^_2023-01-27 ^{Fast PR Analysis Compatibility Fix} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.10 ^_2023-01-13 ^{Improved FIPS Compliance} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.9.2 ^_2022-12-14 ^{Bug Fix Release related to PR analysis} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.9.1 ^_2022-12-06 ^{Bug Fix Release} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.9.0 ^_2022-12-01 ^{.NET 7 bug fixes and preparation for fast PR analysis} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.8.0 ^_2022-08-24 ^{Analysis of Azure Functions on Github Actions no longer hard fails with default behavior. See release notes for details.} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.7.2 ^_2022-07-12 ^{Log warning instead of error when not parsing environment variables to avoid hard failure when Newtonsoft does not get resolved} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.7.1 ^_2022-06-21 ^{Bug Fix Release} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.7.0 ^_2022-06-20 ^{Bug Fix Release} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.6.0 ^_2022-05-30 ^{Send warnings to users of versions where support will change} Download scanner for: .NET 5+ .NET Global Tool .NET Core 3.1 .NET Core 2.1 .NET Framework 4.6 Release notes

5.5.3 ^_2022-02-14 ^{Support for .NET 6 Web Projects, TLS Version selection logic removed - now responsibility of OS, Fix "MSB3677 Unable to move file" regression} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.5.2 ^_2022-02-10 ^{Support for .NET 6 Web Projects, TLS Version selection logic removed, now responsibility of OS} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.5.1 ^_2022-02-08 ^{Support for .NET 6 Web Projects, support TLS 1.3 where supported by environment} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.5.0 ^_2022-02-07 ^{Support for .NET 6 Web Projects, support TLS 1.3} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.4.1 ^_2021-12-23 ^{Updated Newtonsoft.Json to latest} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.4 ^_2021-11-26 ^{Updated .NET 5 Version to be forward compatible and support .NET 6 environments} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.3.2 ^_2021-10-28 ^{Added parameters sonar.clientcert.path and sonar.clientcert.password for securing connections to SonarQube} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.3.1 ^_2021-09-01 ^{Update scanner-cli, Compile with .NET Core 2.1 and 3.1, Improve uninstall of targets if multiple builds in the same pipeline} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.2.2 ^_2021-06-24 ^{Fix test assembly detection + mTLS certificate with password} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.2.1 ^_2021-04-30 ^{Update embedded SonarScanner CLI} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.2 ^_2021-04-09 ^{Support for test code analysis} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.1 ^_2021-03-09 ^{Support for .NET 5, support for solo .NET Core project (without .sln)} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.0.4 ^_2020-11-11 ^{Support for .NET 5, support for solo .NET Core project (without .sln)} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.0.3 ^_2020-11-10 ^{Support for .NET 5, support for solo .NET Core project (without .sln)} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

5.0 ^_2020-11-05 ^{Support for .NET 5, support for solo .NET Core project (without .sln)} Download scanner for: .NET 5+ .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

4.10 ^_2020-06-29 ^{Support FIPS compliant cryptographic algorithm} Download scanner for: .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

4.9 ^_2020-05-05 ^{Improve detection of duplicated coverage reports, fix categorization of fakes projects} Download scanner for: .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

4.8 ^_2019-11-06 ^{Enable scanner execution when only .NET Core 3 is installed} Download scanner for: .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

4.7.1 ^_2019-09-10 ^{Update SonarScanner to version 4.1} Download scanner for: .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

4.7 ^_2019-09-03 ^{Support dash and forward-slash in dotnet command line arguments, analyze XAML files, add analyzed targets in logs} Download scanner for: .NET Global Tool .NET Core 2.1 .NET Framework 4.6 Release notes

The SonarScanner for .NET version 9.2 has been deprecated and should not be used.

Beginning with the Sonar Scanner for .NET v8, the way the sonar.projectBaseDir property is automatically detected has changed which has an impact on the files that are analyzed and how relative properties, such as sonar.exclusions and sonar.test.exclusions, are resolved.

To customize the behavior, you can set the sonar.projectBaseDir property to point to a directory that contains all the source code you want to analyze. The path may be relative (to the directory from which the analysis was started) or absolute.

Prerequisites

From version 7.0, Java is no longer required because the scanner will download it automatically.
- If internet access is limited in your configuration, skip the JRE auto-provisioning and use the Java version installed locally.
The SDK corresponding to your build system:
- For the .NET Framework v4.6.2: use either the Build Tools for Visual Studio 2015 Update 3, or the Build Tools for Visual Studio.
- If you are using the .NET version of the scanner or the .NET Core Global Tool, you will need .NET Core SDK 3.1 and above.

The flavor (either .NET Framework, .NET Core or .NET) used to compile the Scanner for .NET is independent of the .NET version used to build the project you want to analyze. Concretely, you can analyze .NET Core code with the .NET Framework version of the Scanner. It’s only relevant depending on your OS, and on the versions of .NET SDKs that are installed on your build machine.

Installation

.NET Core Global Tool

Using the dotnet install tool from the command line is the simplest way to install the scanner if you are using .NET Core or later on an already installed instance of SonarQube Server. The .NET Core Global Tool is available from .NET Core 3.1+.

dotnet tool install --global dotnet-sonarscanner --version x.x.x

The --version argument is optional; if omitted, the latest version will be installed. The full list of release versions is available on the NuGet page.

If you can’t use the dotnet install tool, other Core versions are available for download in the SonarScanner Update Center collapsible (access above at the very top of the page).

Standalone executable

Expand the downloaded file into the directory of your choice. We’ll refer to it as $install_directory in the following steps.
- On Windows, you might need to unblock the ZIP file first (right-click File > Properties > Unblock).
- On Linux/OSX you may need to set execute permissions on the files in $install_directory/sonar-scanner-(version)/bin.
Uncomment, and update the global settings to point to SonarQube Cloud by editing $install_directory/SonarQube.Analysis.xml. Values set in this file will be applied to all analyses of all projects unless overwritten locally. Consider setting file system permissions to restrict access to this file:

<SonarQubeAnalysisProperties  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sonarsource.com/msbuild/integration/2015/1">
  <Property Name="sonar.host.url">https://sonarcloud.io</Property>
  <Property Name="sonar.token">[my-user-token]</Property>
</SonarQubeAnalysisProperties>

Add $install_directory to your PATH environment variable.

PreviousIntroduction NextUsing the scanner

Last updated 15 days ago

Was this helpful?

Prerequisites

Installation

.NET Core Global Tool

Standalone executable

Related pages