RubyMine 2019.1 Help

Configuring Ruby interpreter

RubyMine enables you to choose the required Ruby interpreter for a current project or newly created projects. The IDE automatically detects interpreters installed on a local machine and maintained by version managers. Moreover, you can add additional local or remote interpreters (Docker, Vagrant, SSH, and so on).

The following interpreters are supported:

  • Ruby MRI (version 1.8.7 and later)

  • JRuby

  • Rubinius (without debugging)

  • TruffleRuby (without debugging)

Select Ruby interpreter

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

  1. Invoke the Settings/Preferences dialog (Ctrl+Alt+S) and go to the Ruby SDK and Gems page.

  2. (Optional) If RubyMine has multiple projects opened, select the required one to define a Ruby interpreter.

  3. Choose the required Ruby interpreter. You can also choose the gemset for the RVM and rbenv version managers.

    Ruby SDK and Gems page

  4. For the selected Ruby interpreter/gemset, you can see the installed gems on the right. Learn more about Ruby gems support at Ruby gems support.

If you use RVM or rbenv to manage local Ruby SDKs, you can quickly set the required interpreter in the following way:

  1. Press Ctrl twice.

  2. In the invoked popup, start typing rvm use or rbenv shell, select the required interpreter and press Enter.

  3. (Optional) If necessary, click the Rollback button in the popup that informs about the changed SDK.

Add local Ruby interpreter

RubyMine automatically detects local interpreters installed using version managers. To add the required local interpreter manually, perform the following steps:

  1. In the Ruby SDK and Gems page, click the add button and select New local…:

    New local interpreter

  2. Provide a path to the Ruby executable (for example, /usr/local/bin/ruby for Ruby installed to macOS using Homebrew). RubyMine will display the selected interpreter along with automatically detected interpreters.

    Ruby SDK and Gems page

  3. To remove the interpreter from the list, select it and click the remove button.

Add remote Ruby interpreter

To configure a remote Ruby interpreter, follow these steps:

To configure a remote Ruby interpreter, follow these steps:

  1. In the toolbar, click add, and choose New remote...:

    New remote interpreter

  2. In the Configure Remote Ruby Interpreter dialog, select the desired option (Deployment configuration, SSH Credentials, and so on) and specify the required settings.

    Configure remote ruby interpreter

Last modified: 8 May 2019

See Also


Language and Framework-Specific Guidelines: