Configuring Remote Ruby Interpreter

Prerequisite

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 , 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:

  ~/.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: .

  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.