IntelliJ IDEA 2018.3 Help

Configuring SDK Gemsets

IntelliJ IDEA provides the capability to work with gemsets for the RVM and rbenv version managers.

To see gemsets available for the installed interpreters, open the Product Structure dialog (Ctrl+Shift+Alt+S) and go to the Modules page. Then, go to the Ruby SDK and Gems page. On this page, the gemsets are shown as the interpreter children:

Ruby SDK and Gems page for RVM

For RVM, you can select a certain gemset and install project gems to this gemset. On the other hand, the rbenv version manager provides the ability to select several gemsets for a project:

Ruby SDK and Gems page for rbenv

In this case, gems will be installed to the first enabled gemset. See Install Gems to Local Interpreter for instructions on how to install gems.

Create RVM gemsets for an existing project

To create an RVM gemset in the Product Structure dialog (Ctrl+Shift+Alt+S), go to the Modules | Ruby SDK and Gems page and perform the following steps:

  1. Click the add button:

    Ruby SDK and Gems page

  2. In the popup, select New RVM gemset…:

    new RVM gemset popup

  3. In the dialog that opens, select the Ruby SDK, for which the gemset will be created. Then, specify the gemset name and click OK:

    create new rvm gemset dialog

  4. The Ruby SDK and Gems page will show the gemset as a child of the selected SDK:

    Ruby SDK and Gems page
    Note that the asterisk is appended to the gemset name. This means that gemset is not created yet. To create it, click Apply or OK in the Product Structure dialog.

Create Rbenv gemsets using .rbenv-gemset

IntelliJ IDEA enables you to work with rbenv gemsets using the rbenv-gemsets plugin. In this case, the .rbenv-gemsets file manages project gemsets. IntelliJ IDEA synchronizes the gemsets enabled in the Ruby SDK and Gems page with the ones specified in .rbenv-gemsets. For instance, if you uncheck the gemset in Ruby SDK and Gems, the corresponding record will be removed from the .rbenv-gemsets file.

Furthermore, you can create and disable gemsets right in the editor:

  1. Open the project’s .rbenv-gemsets file.

  2. Type the required gemset name on a separate line.

  3. Use the Create gemset ‘name’ quick fix to create a gemset:

    Create gemset quick fix
    This gemset will be shown as the child of the current SDK:
    Ruby SDK and Gems page

  4. If you remove this gemset from the .rbenv-gemsets, click Update libraries:

    update libraries in the editor
    The gemset will be disabled for the current SDK.

Last modified: 19 December 2018

See Also

External Links: