Installing a plugin
On this page
You need to manually install plugins when using SonarQube Server (you cannot use the SonarQube Marketplace).
To see what plugins are available and which version is appropriate for your SonarQube Server, use the plugin version matrix, which is kept up to date with current plugin availability and compatibility.
Plugins are not provided by SonarSource; therefore, you install them at your own risk. A SonarQube Server administrator needs to acknowledge this risk in the Marketplace before installing plugins or when prompted in SonarQube Server after installing a plugin manually.
Installing a plugin
In case of a Data Center Edition:
- Plugins are not shared, meaning if you install/uninstall/upgrade a given plugin on one application node, you need to perform the same actions on the other application nodes.
- All application nodes must be stopped when installing, uninstalling, or upgrading a plugin.
- Download the plugin you want to install. The version needs to be compatible with your SonarQube version.
- Put the downloaded jar in
<sonarqubeHome>/extensions/plugins, and remove any previous versions of the same plugins. - Restart your SonarQube.
When running SonarQube Server under Docker, any plugin you want to install must also be copied into the Docker volume you create during installation. See the Installing SonarQube Server from the Docker image article in our documentation for more details about creating the volume and container.
Let’s assume that your SonarQube Server docker container is called sonarqube. The easiest way to install manually a plugin in the container is the following.
- Check if an existing version of the plugin exists. Run
docker exec sonarqube bash -c 'ls "$SONARQUBE_HOME"/extensions/plugins'to see the entire list of plugins that are installed manually. - If a previous version of the plugin is listed, remove it using
docker exec sonarqube bash -c 'rm "$SONARQUBE_HOME"/extensions/plugins/<PLUGIN_JAR_FILE_NAME>' - Install the new plugin using
docker exec sonarqube bash -c 'wget <PLUGIN_JAR_URL> -P "$SONARQUBE_HOME"/extensions/plugins/' - Restart the SonarQube Server docker container using
docker restart sonarqube
Note that if you have followed the guidelines outlined on this page, the resulting plugin will be available in the sonarqube_extensions volume, which is attached to the <SONARQUBE_HOME>/extensions/plugins folder.
- Download the appropriate plugin JAR file from a trusted source, ensuring it's compatible with your SonarQube version.
- Copy the Plugin into your SonarQube container using
kubectl cp. You'll need the pod name, container name, and the path to the plugin on your local machine.
kubectl cp /path/to/plugin.jar <pod-name>:<sonarqube_extensions_path>/plugin.jar -c <container-name>3. Restart SonarQube
To verify the plugin installation, go to Administration > Marketplace.
Uninstalling a plugin
To uninstall a plugin:
- Delete the plugin from the
<sonarqubeHome>/extensions/pluginsfolder. - Restart your SonarQube Server.
Was this page helpful?
© 2008-2025 SonarSource SA. All rights reserved.
