RubyMine 2017.1 Help

Configuring Remote Ruby Interpreters

In this section:

Prerequisite

Before you start working with remote interpreters, make sure that the SSH Remote Run plugin is enabled. The plugin is bundled with RubyMine 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

RubyMine provides full integration with the Ruby interpreters running on remote hosts.

Note that the name of a remote interpreter is automatically prepended with the prefix Remote.

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 in the Ruby interpreter path field of the Ruby SDK and Gems page of the Settings/Preferences dialog:
    <rvm root>/gems/<gemset>

    For example, on MacOS/Linux:

    ~/.rvm/gems/ruby-2.2.2@rails

    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.
    /help/img/idea/2017.1/rm_remote_interpreter_toolbar.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.

See Also

Last modified: 18 July 2017