How to use Vagrant with Parallels Desktop

53 users found this article helpful


I would like to use Vagrant with Parallels Desktop. How can I set it up?

Note: This article only briefly explains how to set up Vagrant to work with Parallels Desktop. For more information and documentation, please visit Parallels + Vagrant website.


First, make sure that you have Parallels Desktop for Mac Pro or Business Edition and Vagrant properly installed.

After installing Vagrant, install and update Parallels plugin for Vagrant.

  1. Start Terminal and execute:

    vagrant plugin install vagrant-parallels

    NOTE: the command above will download and install the latest version of Parallels plugin for Vagrant. If you believe you current version of plugin needs to be updated, please use the following command:

    vagrant plugin update vagrant-parallels

    NOTE: You may receive an error message stating that json is not installed, or that Xcode EULA is not agreed. Proceed with instructions written in the error message.

  2. Now create a directory where you would like to store Vagrant boxes:

    mkdir new_vagrant_project
    cd new_vagrant_project
  3. Now initialize Vagrant environment (we recommend using boxes prepared by the Bento community project) :

    vagrant init bento/ubuntu-20.04
  4. Create and run a virtual machine:

    vagrant up

The Parallels provider has a higher priority then any other provider built into Vagrant. Parallels provider will be used by default for your Vagrant virtual machines.

If you are using multiple Vagrant providers simultaneousely and want to run your virtual machine with another provider, please read the general basic usage page for providers.

In order to setup a new project, please check Getting Started page.

For configuration, please check this webpage.

And this page for networking.

Was this article helpful?

Tell us how we can improve it.