RubyMine 2024.1 Help


Vagrant is a tool for building and managing virtual machine environments defined by Vagrantfile configuration files. RubyMine provides integration with Vagrant and allows you to perform all the required actions in your project - from initializing a Vagrant environment to executing Vagrant commands. Moreover, RubyMine allows you to use the running virtual machine as a remote interpreter. This means that you can run, debug, and test your application in an isolated environment right from the IDE.

In this topic, we'll cover the main Vagrant capabilities available in RubyMine: configuring Vagrant, adding and removing boxes, running Vagrant commands. We'll also show how to run the sample Rails application inside a virtual machine by configuring a remote interpreter.


To start working with Vagrant, do the following.

Vagrant init

To initialize a Vagrant environment for the opened project, follow the steps below.

  1. Go to Tools | Vagrant | Init in Project Root.

  2. In the invoked dialog, specify the box name and URL, for example:

    • Box name: ubuntu/bionic64

    • Box URL:

    If you already have several Vagrant boxes, select the desired one in the invoked Select Vagrant Box popup.

  3. Wait until RubyMine downloads the specified box and initializes a Vagrantfile.

  4. Change the Vagrantfile in the following way:

    Vagrant.configure("2") do |config| = "ubuntu/bionic64" config.vm.synced_folder ".", "/home/vagrant/sample_rails_app" "forwarded_port", guest: 3000, host: 3000 end

    The following settings are specified in this configuration:

    • box: Specifies the box used to run the virtual machine.

    • synced_folder: Configures a virtual machine folder to share your local project directory.

    • network: Specifies options used to connect the virtual machine to the network. Here we've configured the port on the virtual machine to share via a port on the host machine.

Vagrant up

After initializing a Vagrant environment, you can create and run a virtual machine based on the Vagrantfile settings.

  1. Go to Tools | Vagrant | Up.

  2. (Optional) Select the project's Vagrantfile.

  3. If several machines are defined in your Vagrantfile, select the desired machine.

    Select virtual machine configuration
  4. Wait until RubyMine creates and runs the machine.

    Run tool window: vagrant up

    You can now connect to this machine using SSH to install additional libraries, run the application, and so on. Moreover, you can configure this machine as a remote interpreter to run, debug, and test your application in an isolated environment right from the IDE.

SSH into a running machine

To connect to the running virtual machine, follow the steps below.

  1. Go to Tools | Start SSH session.

  2. In the invoked popup, choose the desired Vagrant host.

    Select host to connect
  3. (Optional) If several machines are running, select the desired one.

    Select Vagrant machine
  4. In the tab of the opened Terminal window, you can execute a shell command, for example, you can install additional libraries, run the application, and so on.

    SSH terminal session

Add Vagrant as a remote interpreter

RubyMine allows you to use the running virtual machine with Ruby installed as a remote interpreter. This means that you can run, debug, or test your application in an isolated environment right from the IDE. Perform the following steps to do this.

  1. Open the Settings dialog Ctrl+Alt+S, go to the Language & Frameworks | Ruby SDK and Gems page.

  2. Click the Add icon and select Remote Interpreter or Version Manager in the drop-down.

  3. In the invoked dialog, select Vagrant.


    If a project root folder contains a Vagrantfile pointing to a running virtual machine, RubyMine detects the Vagrant Instance Folder automatically and displays the Vagrant Host URL used to access the virtual machine. If necessary, you can change the Vagrant Instance Folder to use another virtual machine.

    In Ruby or version manager path, specify the path to the Ruby interpreter or the version manager executable. Click OK.

  4. (Optional) If you specified a path to the version manager executable on the previous step, RubyMine suggests selecting the Ruby interpreter used to run a remote application.

  5. Select the added SDK in the Ruby SDK and Gems page and click OK.

    Ruby SDK and Gems page: Vagrant

    Wait until RubyMine downloads gems from the remote machine to local caches. This is required for indexing.

  6. (Optional) If you want to use the added SDK to debug a remote process, specify mappings between files of the local and remote project. To do this, click the Edit Path Mappings button. In the Edit Project Path Mappings dialog, specify the local and remote project root paths.

    Edit Project Path Mappings

    RubyMine detects the Vagrant synced folders and adds corresponding mappings automatically.

After you've configured Vagrant as the remote interpreter, you can:

Vagrant settings

You can configure the following Vagrant settings on the Tools | Vagrant page of the Settings dialog Ctrl+Alt+S:

Vagrant executable

Specify the Vagrant executable file if RubyMine didn't detect it automatically or you want to use a different one.

Example: vagrant

Instance Folder

Specify the fully qualified path to the directory where the Vagrantfile is initialized and stored. By default, RubyMine uses the root of your current project to execute Vagrant commands. This directory is used when executing Vagrant commands, such as vagrant up, vagrant reload, vagrant halt, and so on.

Example: /Users/jetbrains/RubymineProjects/sample_rails_app


Select the provider used as a backend to run a virtual machine. You can install the required provider as the Vagrant plugin on the Plugins tab.

Examples: aws, libvirt

Environment variables

Environment variables enable you to pass the required values for configuring a provider. To specify environment variables, click the Browse button (Shift+Enter). For example, the vagrant-aws provider allows you to pass your AWS credentials using the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables. You can read variable values in Vagrantfile when instantiating AWS instances.

config.vm.provider 'aws' do |aws| aws.access_key_id = ENV['AWS_ACCESS_KEY_ID'] aws.secret_access_key = ENV['AWS_SECRET_ACCESS_KEY'] # ... end

This list shows the available Vagrant boxes. To add a new box, click the Add button Alt+Insert and specify the box name and URL. For example:

  • Box name: ubuntu/bionic64

  • Box URL:

To remove a selected box, click the the Remove button button Alt+Delete.


Use this table to add, remove, and update Vagrant plugins. For example, to install the vagrant-aws plugin, click the Add button Alt+Insert, enter vagrant-aws in the invoked dialog and click OK.

Last modified: 11 February 2024