Configure a Ruby interpreter

1. Open the Settings dialog CtrlAlt0S.

2. In the Ruby SDK and Gems page, click the button and select Interpreter:

   

3. Provide a path to the Ruby executable, for example:

   • /usr/local/bin/ruby for Ruby installed on macOS using Homebrew.

   • /usr/bin/ruby for Ruby installed on Linux using apt.

   • C:\Ruby26-x64\bin\ruby.exe for Ruby installed on Windows using RubyInstaller.

   RubyMine will display the added interpreter along with automatically detected interpreters.

   

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

   tip

   Click to display paths to interpreters in the list.

RubyMine allows you to use your custom environment for running any Ruby command from within RubyMine. To do this, you need to provide environment variable values or a path to a configuration script when adding a local interpreter.

1. Open the Settings dialog CtrlAlt0S.

2. In the Ruby SDK and Gems page, click the button and select Interpreter with Custom Environment:

3. In the invoked dialog, provide a path to the Ruby executable as described in Add an interpreter. Then, configure the Custom environment in one of the following ways:

   • Specify the environment variable values directly.

     Example: env API_KEY=123

   • If you use a shell script to load environment variables, you need to provide an absolute path to this script.

     Example: /bin/bash /Users/jetbrains/sample_app/env.sh

     tip

     Note that the *.sh file should have "$@" at the end to allow RubyMine to pass some commands required for adding an interpreter.

   • If you use direnv to load and unload environment variables, pass a path to the directory with the .envrc file to the direnv exec command.

     Example: direnv exec /Users/jetbrains/sample_app

   • If you use Shadowenv to customize your project environment, pass a path to the project directory to the shadow exec command.

     Example: shadowenv exec --dir /Users/jetbrains/sample_app --

   Click OK to add an interpreter.

4. Select the added interpreter and click OK in the Settings dialog.

To select the auto-detected Ruby interpreter maintained by the version manager, follow the steps below:

1. Invoke the Settings dialog CtrlAlt0S and go to the Ruby SDK and Gems page.

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

   

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

tip

If you have issues with detecting local Ruby interpreters maintained by your version manager, follow the steps from Debug Ruby interpreter detection.

If you use RVM or rbenv to manage local Ruby SDKs, you can quickly set the required interpreter using Run Anything:

1. Press Ctrl twice.

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

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