Managing Plugins

Plugins are extensions to JetBrains Rider core functionality. They provide the IDE integration with version control systems (VCS) and application servers, add support for various development technologies, frameworks and programming languages, and so on.

The more plugins are installed and enabled, the more features you have available. On the other hand, disabling unnecessary plugins may increase performance, especially on "less powerful" computers.

Certain plugins are independent, certain are not. Dependent plugins require other plugins to be enabled.

If necessary, you can add an installed plugin to the list of required plugins for the current solution.

To enable/disable plugins

Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Plugins.
In the right-hand part of the dialog, use checkboxes to enable or disable plugins.
If the plugin of interest is not present in the list (which may be the case for a repository plugin), you can download and install the plugin.
Restart JetBrains Rider for the changes to take effect.

Categories of plugins

In relation to JetBrains Rider, plugins may be attributed to one of the following categories:

Plugins bundled with the IDE. These plugins are installed and enabled by default. You can disable unnecessary bundled plugins, but you cannot uninstall them.
Repository plugins, that is, plugins stored in plugin repositories (e.g., the JetBrains Plugin Repository). To be able to use the repository plugins, you should download and install them.

Plugin repositories

JetBrains Rider provides access to JetBrains Rider Plugin Repository at http://plugins.jetbrains.com/rider. You can also set up your own enterprise plugin repositories, for example, to store plugins that you want to reserve for your company's internal use only. (A plugin repository corresponds to one or more Web servers.)

To be able to use repository plugins, you have to download and install such plugins first. After that, you get the ability to update these plugins when appropriate.

When a repository plugin becomes unnecessary, you can disable or uninstall it.

To download and install a repository plugin

Note that the plugin you have installed is automatically enabled. When necessary, you can disable it as described above.

Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Plugins.
Click Install JetBrains plugin or Browse repositories.
In the Browse Repositories dialog that opens, right-click the required plugin and select Download and Install.
Note that when looking for the plugin of interest, you can filter the plugins list and perform a search.
Confirm your intention to download and install the selected plugin.
Click Close.
Click OK in the Settings dialog and restart JetBrains Rider for the changes to take effect.

To update a repository plugin

Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Plugins.
Right-click any of the plugins and select Reload List of Plugins.
The names of repository plugins that have newer versions available are shown blue.
Right-click the necessary plugin and select Update Plugin.
Click OK in the Settings dialog and restart JetBrains Rider for the changes to take effect.

To uninstall a repository plugin

Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Plugins.
Right-click the repository plugin to be uninstalled and select Uninstall.
Confirm your intention to uninstall the selected plugin.
Click OK in the Settings dialog and restart JetBrains Rider for the changes to take effect.

To be able to use plugin repositories other than the JetBrains Plugin Repository (e.g., your enterprise plugin repositories), you should specify their URLs in JetBrains Rider.

To add plugin repositories

Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Plugins.
Click Browse repositories.
In the Browse Repositories dialog, click Manage repositories.
In the Custom Plugin Repositories dialog, click and specify the repository URL. Click Check Now to make sure that the URL is correct.

Alternatively, you can add the repositories by editing the JetBrains Rider custom .properties, or custom .vmoptions file:

To replace JetBrains repositories with your own ones

Open the JetBrains Rider custom .properties, or custom .vmoptions file for editing: Help | Edit Custom Properties or Help | Edit Custom VM Options.
Depending on the file, add the following line:
- idea.plugins.host=<yourRepositoryURL> for the .properties file.
- -Didea.plugins.host=<yourRepositoryURL> for the .vmoptions file.
You can actually add any number of custom repositories. Depending on the file, add the following line:
- idea.plugin.hosts=<URL1>;<URL2>;...<URLn> for the .properties file.
- -Didea.plugin.hosts=<URL1>;<URL2>;...<URLn> for the .vmoptions file.
Make sure that there is no option that points to http://plugins.jetbrains.com or https://plugins.jetbrains.com.
Restart JetBrains Rider. As a result, the specified repository becomes your main plugin repository. You can now add repositories as described in Adding repositories.

To be available to JetBrains Rider users, all enterprise repository plugins must be listed in the file updatePlugins.xml along with their URLs and version numbers. This file must be available at the URL specified for the corresponding repository.

The plugins themselves are identified by their individual URLs and thus may be located on different Web servers.

To add a plugin to an enterprise plugin repository

Upload your plugin JAR onto a Web server.
Add the plugin definition to updatePlugins.xml. If this file doesn't yet exist, create it at the location corresponding to the repository URL.
The plugin definition in updatePlugins.xml may look similar to this:

<plugins> ... <plugin id="MyPlugin" url="http://plugins.example.com:8080/myPlugin.jar" version="1.0"/> ... </plugins>
To publish a new version of the same plugin, upload the corresponding plugin JAR to the repository, and change the value of the version attribute in the plugin definition.

The file updatePlugins.xml must correspond to the following Document Type Definition (DTD):

<!DOCTYPE plugins [
    <!ELEMENT
      plugins(plugin)*>
    <!ELEMENT
      plugin (#PCDATA)>
    <!ATTLIST
      plugin id CDATA #REQUIRED url DATA #REQUIRED version CDATA #REQUIRED>]>

Installing plugins from disk

If you have a plugin file available on your computer, you can install it from disk. A plugin file is an archive file (ZIP or a JAR) and you do not need to decompress it before installation.

To install a plugin from disk

Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Plugins.
In the right-hand part, on the Plugins page, click Install plugin from disk.
In the dialog that opens, select the plugin archive file, and click OK.
In the Settings / Preferences dialog, click Apply or OK.
If suggested, restart JetBrains Rider.

Managing required plugins

When working on a project, you can install plugins that provide support for a certain technology or a framework. If necessary, you can add such plugins to the list of required plugins for the current project. JetBrains Rider in this case will ensure that the plugins that are necessary for your project to work are available.

To manage required plugins

Install the required plugin.
Press Ctrl+Alt+S to open the Settings/Preferences dialog and then go to Build, Execution, Deployment | Required Plugins.
On the Required Plugins page, use the , , and buttons to manage the list of required plugins.
To add a required plugin, click and provide the name of the plugin in the dialog that opens. Optionally, provide the required minimum and maximum plugin versions and the preferred update channel.

After the required plugin is added, on opening a solution JetBrains Rider will notify you if any of the required plugins is disabled, not installed, or requires an update.

Click the link in the notification message to quickly enable, install, or update the required plugin.

Last modified: 21 December 2018