IntelliJ IDEA 2017.3 Help

Configuring Remote Ruby Interpreter

This feature is only supported in the Ultimate edition.

The following is only valid when Ruby Plugin is installed and enabled!


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 settings 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 Modules node.
  3. In the Gems tab, click add, and from the popup menu, choose New remote...:
    ij add remote ruby interpreter
  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: edit path mapping icon.

    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: 6 March 2018