Skip to content


Repository files navigation


Gem Version CI

A Test Kitchen Driver for HashiCorp Vagrant.

This driver works by generating a single Vagrantfile for each instance in a sandboxed directory. Since the Vagrantfile is written out on disk, Vagrant needs absolutely no knowledge of Test Kitchen. So no Vagrant plugins are required.



Vagrant version of 2.4 or later.


The kitchen-vagrant driver ships as part of Chef Workstation. The easiest way to use this driver is to use it with Chef Workstation.

If you want to install the driver directly into a Ruby installation:

gem install kitchen-vagrant

If you're using Bundler, simply add it to your Gemfile:

gem "kitchen-vagrant"

... and then run bundle install.

Configuration and Usage

See the Vagrant Driver Page for documentation on configuring this driver.


Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Created by Fletcher Nichol (


Apache 2.0 (see LICENSE)