JetBrains Rider 2017.2 Help

Installing and Setting Up Rider

Download and install JetBrains Rider

To install JetBrains Rider

  1. Download JetBrains Rider (select a version depending on your operating system).
  2. Do the following depending on your operating system:
    • Windows installation:
      1. Run the *.exe file you've downloaded.
      2. Follow the instructions in the installation wizard.
    • MacOS installation:
      1. Open the .dmg package that you've downloaded, and drag JetBrains Rider to the Applications folder.
    • Linux installation:

      1. Unpack the JetBrains.Rider-*.tar.gz file to a different folder, if your current "Download" folder doesn't support file execution:
        tar xfz JetBrains.Rider-*.tar.gz -C <new_archive_folder>

        The recommended install location according to the filesystem hierarchy standard (FHS) is /opt. For example, it's possible to enter the following command:

        sudo tar xf JetBrains.Rider-*.tar.gz -C /opt/
      2. Switch to the bin directory:
        cd <new archive folder>/JetBrains.Rider-*/bin
        For example,
        cd opt/JetBrains.Rider-*/bin
      3. Run from the bin subdirectory.

Run JetBrains Rider for the first time

Import JetBrains Rider settings

When you start JetBrains Rider for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings:

If this is your first instance of JetBrains Rider, choose the Do not import settings option.

Register JetBrains Rider

To try and evaluate JetBrains Rider, you can download and install its trial version for free. The trial version is available for 30 days, whereupon you need to obtain and register a license.


Select how you want to register JetBrains Rider:

  • JetBrains Account: select this option if you have a JetBrains Account that allows you to access your purchases and manage licenses (see What is JetBrains Account? to learn more).
  • Activation code: select this option if you have an activation code for JetBrains Rider, and paste it to the text area.
  • License server: select this option to register JetBrains Rider through the License Server web application that allows you to manage floating licenses and issue licenses to users who do not have direct internet access.

You can change your selection later on by going to Help | Register from the main menu.

Customize your JetBrains Rider environment

Follow the Customize JetBrains Rider wizard steps to configure your working environment to your liking, or skip these steps and keep default settings by pressing a corresponding button. In any case you'll be able to change the setting later.

  1. Select the user interface theme. You can choose between the default light theme and the Darcula theme.

  2. Choose the editor color schemes you feel more comfortable with:

    • ReSharper Light — a default ReSharper scheme
    • Visual Studio light — a Visual Studio alike scheme
    • Default — an IntelliJ IDEA alike scheme
  3. Choose the keymap (the shortcuts scheme):

    • Visual Studio keymap — a Visual Studio alike scheme
    • ReSharper keymap — similar to the "IntelliJ IDEA" scheme in ReSharper
    • Rider keymap — an IntelliJ IDEA alike scheme

    See the keymaps comparison table for Windows/Linux and macOS.

  4. Disable unnecessary default plugins.

    JetBrains Rider is shipped with a variety of plugins that provide integration with different version control systems and application servers, add support for various frameworks and development technologies, etc.

    You can disable the plugins you do not need to increase JetBrains Rider performance. If necessary, you can re-enable them later in the Settings dialog (Ctrl+Alt+S), under Plugins.

    Click the Disable All link for each group of plugins to disable them all, or Customize to disable individual plugins.

  5. Get additional plugins.

    Download and install additional plugins (that are not bundled with the IDE) from the JetBrains Rider plugins repository:

Start a project in JetBrains Rider

After you have completed initial JetBrains Rider configuration, the Welcome screen will be displayed. It allows you to:

Welcome to Rider

Update JetBrains Rider

  1. Download the latest version of JetBrains Rider.
  2. Launch the setup as described in Download and install JetBrains Rider.
  3. Choose whether you want to uninstall the existing product version together with its settings, caches and local history and follow the instructions of the installation wizard.

Manage JetBrains Rider through Toolbox App

Toolbox App is an control panel that allows you to manage all JetBrains developer tools, including JetBrains Rider, as well as your projects, from a single point of access. It lets you maintain different versions of the same tool, install updates and roll them back if needed. It also remembers your JetBrains Account and uses it to automatically log you in when you install and register new tools.

  1. Download Toolbox App.
  2. Launch the setup file.
  3. When the installation is complete, accept the JetBrains privacy policy and sign in to your JetBrains Account.

Now you can manage existing tools, install new tools and download updates:

rider toolbox app
Last modified: 27 December 2017