From 2d4149aac7c0befee5343764e376f46c95a656be Mon Sep 17 00:00:00 2001 From: michaelbirnstiehl Date: Mon, 22 Mar 2021 13:43:28 -0500 Subject: [PATCH] SONAR-14623 Add note about accepting plugin risks --- .../src/pages/setup/install-plugin.md | 25 ++++++++----------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/server/sonar-docs/src/pages/setup/install-plugin.md b/server/sonar-docs/src/pages/setup/install-plugin.md index 1c04d9bbe84..687920b1a12 100644 --- a/server/sonar-docs/src/pages/setup/install-plugin.md +++ b/server/sonar-docs/src/pages/setup/install-plugin.md @@ -3,33 +3,30 @@ title: Install a Plugin url: /setup/install-plugin/ --- - -There are two options to install a plugin into SonarQube: +There are two ways to install plugins in SonarQube: -- Marketplace - Installs plugins automatically, from the SonarQube UI. -- Manual Installation - You'll use this method if your SonarQube instance doesn't have access to the Internet. +- **Marketplace** - Automatically installs plugins from the SonarQube UI. +- **Manual Installation** - You can use this method if your SonarQube instance doesn't have Internet access, if you're using Data Center Edition, or if the plugin isn't in the Marketplace. + +[[warning]] +| Installing third-party plugins is inherently risky. You must acknowledge this risk before you install or update plugins. ## Marketplace -If you have access to the Internet and you are connected with a SonarQube user having the Global Permission "Administer System", you can go to Administration > Marketplace. +If your SonarQube instance has access to the Internet, and you're connected with a SonarQube user with the **Administer System** global permission, you can find the Marketplace at **Administration > Marketplace**. From here: - Find the plugin you want to install -- Click on Install and wait for the download to be processed +- Click **Install** and wait for the download to be processed -Once download is complete, a "Restart" button will be available to restart your instance. +Once the download is complete, a **Restart** button will be available to restart your instance. See [Marketplace](/instance-administration/marketplace/) for more details on how to configure your SonarQube Server to connect to the Internet. ## Manual Installation -In the page dedicated to the plugin you want to install (ex: for Python: SonarPython), click on the "Download" link of the version compatible with your SonarQube version. +Download the plugin you want to install. The version needs to be compatible with your SonarQube version. Put the downloaded jar in `$SONARQUBE_HOME/extensions/plugins`, removing any previous versions of the same plugins. -Once done, you will need to restart your SonarQube Server. - -### License - -If you installed a Commercial Edition, you will need to set the License Key in Administration > Configuration > License Manager before being able to use it. +Once done, you need to restart your SonarQube server. - -- 2.39.5