Installation

Installation

The Vagrant VMware provider can be installed using the standard plugin installation procedure. VMware Fusion users should run:

$ vagrant plugin install vagrant-vmware-fusion

VMware Workstation users should run:

$ vagrant plugin install vagrant-vmware-workstation

For more information on plugin installation, please see the Vagrant plugin usage documentation.

The Vagrant VMware plugins are commercial products provided by HashiCorp and require the purchase of a license to operate. To purchase a license, please visit the Vagrant VMware provider page. Upon purchasing a license, you will receive a license file in your inbox. Download this file and save it to a temporary location on your computer.

Warning! You cannot use your VMware product license as a Vagrant VMware plugin license. They are separate commercial products, each requiring their own license.

After installing the correct Vagrant VMware product plugin for your system, you will need to install the license. For VMware Fusion users:

$ vagrant plugin license vagrant-vmware-fusion ~/license.lic

For VMware Workstation users:

$ vagrant plugin license vagrant-vmware-workstation ~/license.lic

The first parameter is the name of the plugin, and the second parameter is the path to the license file on disk. Please be sure to replace ~/license.lic with the path where you temporarily saved the downloaded license file to disk. After you have installed the plugin license, you may remove the temporary file.

To verify the license installation, run:

$ vagrant plugin list

If the license is not installed correctly, you will see an error message.

Frequently Asked Questions

Q: I purchased a Vagrant VMware plugin license, but I did not receive an email?
First, please check your JUNK or SPAM folders. Since the license comes from an automated system, it might have been flagged as spam by your email provider. If you do not see the email there, please contact support and include the original order number.

Q: Do I need to keep the Vagrant VMware plugin license file on disk?
After you have installed the Vagrant VMware plugin license, it is safe to remove your copy from disk. Vagrant copies the license into its structure for reference on boot.

Q: I lost my original email, where can I download my Vagrant VMware plugin license again?
Please contact support. Note: please contact support using the email address with which you made the original purchase. If you use an alternate email, you will be asked to verify that you are the owner of the requested license.

Q: I upgraded my VMware product and now my license is invalid?
The Vagrant VMware plugin licenses are valid for specific VMware product versions at the time of purchase. When new versions of VMware products are released, significant changes to the plugin code are often required to support this new version. For this reason, you may need to upgrade your current license to work with the new version of the VMware product. Customers can check their license upgrade eligibility by visiting the License Upgrade Center and entering the email address with which they made the original purchase.

Your existing license will continue to work with all previous versions of the VMware products. If you do not wish to update at this time, you can rollback your VMware installation to an older version.

Q: Why is the Vagrant VMware plugin not working with my trial version of VMware Fusion/Workstation?
The Vagrant VMware Fusion and Vagrant VMware Workstation plugins are not compatible with trial versions of the VMware products. We apologize for the inconvenience.

Q: I accidentally bought the wrong Vagrant VMware plugin, can I switch?
Sure! Even though the Vagrant VMware Fusion plugin and the Vagrant VMware Workstation plugin are different products, they are the same price and fall under the same EULA. As such, we can transfer the license for you. Please contact support.

Q: How do I upgrade my currently installed Vagrant VMware plugin?
You can update the Vagrant VMware plugin to the latest version by re-running the install command. For VMware Fusion:

$ vagrant plugin install vagrant-vmware-fusion

For VMWare Workstation:

$ vagrant plugin install vagrant-vmware-workstation

Support

If you have any issues purchasing, installing, or using the Vagrant VMware plugins, please contact support. To expedite the support process, please include the Vagrant debug output as a Gist if applicable. This will help us more quickly diagnose your issue.