RubyMine 2017.2 Help

Configuring Remote Interpreters via Vagrant


Before you start working with Vagrant, make sure that the Vagrant plugin is enabled. The plugin is bundled with RubyMine and is activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.

Besides that, make sure that the following prerequisites are met (outside of RubyMine):

  • Oracle's VirtualBox is installed on your computer.
  • Vagrant is installed on your computer, and all the necessary infrastructure is created.
  • The parent folders of the following executable files are added to the system PATH variable:
    • vagrant.bat or vagrant from your Vagrant installation. This should be done automatically by the installer.
    • VBoxManage.exe or VBoxManage from your Oracle's VirtualBox installation.
  • The required virtual boxes are created.

Configuring remote Ruby interpreter via Vagrant

To configure a remote Ruby interpreter

  1. In the Ruby SDK and Gems page of the Settings/Preferences dialog box, click /help/img/idea/2017.2/add.png.
  2. From the drop-down list, choose New remote....

    The dialog box Configure Remote Ruby Interpreter opens.

  3. In this dialog box, click the radio button Vagrant:

    In this case, the remote server settings are taken from the vagrant configuration file, defined in the page Vagrant.

  4. Click the browse button /help/img/idea/2017.2/browseButton.png next to the field Vagrant instance folder, and specify the desired Vagrant instance folder.

    This results in showing the link to Vagrant host URL.

  5. The Ruby interpreter path field displays the path to the desired Ruby executable. You can accept default, or specify a different one.
  6. Click OK in the Configure Remote Ruby Interpreter dialog box.
  7. Back in the Ruby SDK and Gems page, if necessary, configure the path mappings:
    1. Click /help/img/idea/2017.2/edit_path_mapping_icon.png:
    2. In the dialog box that opens add (/help/img/idea/2017.2/add.png) or delete (/help/img/idea/2017.2/delete.png) path mappings as desired.
Last modified: 26 October 2017

See Also


Language and Framework-Specific Guidelines: