RubyMine 2017.1 Help

Configuring Ruby Interpreter

In this section:


In RubyMine, you can define several Ruby interpreters. So doing, you can choose the one to be used in your project, from the list of the interpreters available on your machine.

RubyMine supports:

  • Standard Ruby SDKs
  • IronRuby
  • MacRuby

Ruby interpreters can be configured on the following levels:

  • Current project: selected Ruby interpreter will be used for the current project.

    Configuring Ruby SDK on this level is described below.

  • New project: selected Ruby interpreter will be used for the new project instead of the default one.

    Refer to the section Creating Rails-Based Projects for details.

Configuring Ruby SDK for the selected project

To configure Ruby SDK for the current project, follow these steps:

  1. In the Settings/Preferences dialog box, click Ruby SDK and Gems.
  2. If there is more than one project opened in the same window, select the one you want to define a Ruby SDK for.
  3. If all the desired Ruby SDKs are already installed and added to your project, select one from the list of Ruby SDKs. To do that, click the radio button to the left of the desired Ruby SDK, or press Space:

    If the desired Ruby SDK is missing from the list of available SDKs, click /help/img/idea/2017.1/new.png.

    • For the *nix platforms, select from the available rvm or rbenv SDK's and their gemsets, which enables you to switch between the various independent sandboxes. To do that, select the desired interpreter - gemset pair from the list of Ruby SDKs. Refer to RVM Support or Rbenv Support for the details of creating the interpreter - gemset pairs, and to the descriptions of *nix-specific controls. See also Configuring SDK Gemsets page.

      For the non-*nix platforms, choose one from the Select Interpreter Path list, which shows the SDKs that are included in the PATH variable, but has not yet been added to your project.

    • The name of the Ruby interpreter should contain ruby or ir substring. Otherwise, the selected file will not be recognized as the proper Ruby SDK, and RubyMine will display the following error message:
      The selected file is not a valid home for Ruby SDK.
  4. If you are using JRuby, select version from the Language level drop-down list:

    Important notes for JRuby users:

    • jruby.bat is no longer supported, since it causes erratic behaviour for tools that try to spawn new ruby instance (e.g. Rake)
    • Language level cannot be selected for JRuby versions 9.0 and higher.
  5. In the Installed Gems section, RubyMine displays the list of gems that are currently installed on your computer. For each of the installed gems, you can view its version and description.

    Note that RubyMine smartly renders gems' documentation.

    If some gems are missing, or outdated, click /help/img/idea/2017.1/new.png or /help/img/idea/2017.1/refresh.png buttons. Refer to the section Resolving References to Missing Gems.

  6. Apply changes.

See Also

Last modified: 18 July 2017