RubyMine 2018.1 Help

Configuring Remote Ruby Interpreter


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 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 Settings/Preferences.
  2. In the Settings/Preferences dialog (Ctrl+Alt+S), click the Ruby SDK and Gems node.
  3. In the toolbar, click add, and choose New remote...:
    rm 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: 1 August 2018