IntelliJ IDEA 2017.1 Help

Configuring Remote Ruby Interpreter

This feature is supported in the Ultimate edition only.

In this section:


Before you start working with remote interpreters, make sure that the SSH Remote Run plugin is enabled. The plugin is bundled with IntelliJ IDEA and is activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.

Configuring remote Ruby interpreter

To configure a remote Ruby interpreter, follow these steps:

  1. Open the Project Structure dialog (e.g. Ctrl+Shift+Alt+S).
  2. In the Project Structure dialog, click the node Modules.
  3. In the Gems tab, click /help/img/idea/2017.1/new.png, and from the popup menu, choose New remote...:
  4. In the Configure Remote Ruby Interpreter dialog box, select the desired option (Deployment configuration, SSH Credentials etc.).

Important notes

  • rbenv: when configuring a remote interpreter, you have to specify ruby executable located under the directory versions, rather than shims.
  • RVM Support: When adding an rvm-based remote interpreter, it is important to specify the gemset folder instead of the Ruby binary itself:
    <rvm root>/gems/<gemset>

    For example, on MacOS/Linux:


    Note that the name of an rvm-based SDK is automatically prepended with the prefix RVM.

  • An additional icon appears on the toolbar: /help/img/idea/2017.1/edit_path_mapping_icon.png.

    Clicking this icon results in opening the Edit Project Path Mappings dialog box, where you can add or delete the desired path mappings.

Find the detailed tutorial on configuring a remote SDK here.

Last modified: 18 July 2017