Gem Version Linux Build Status Windows Build Status OS X Build Status Code Climate Coverage Status Dependency Status


A Test Kitchen Driver for when you just want to run Chef on localhost.

I swear, there's a reason this driver exists!

TravisCI has a wonderful OS X build environment and AppVeyor a Windows one. This driver allows you to use either as a test environment--having the platform under test be the one running Test Kitchen, rather than a remote cloud server--all while keeping the same Kitchen settings, behavior, and log output you're used to.


Nothing other than a project you wish to test with Test Kitchen and an understanding that this driver will be running against your local machine. If you write a cookbook that formats a hard drive and run it with this driver, bad things will happen.

This driver attempts to minimize cases of multiple test suites clobbering each other by never running concurrently, even if the -c option is passed to Test Kitchen. But everything is still running on the same machine. Don't define multiple suites unless they're okay to run, serially, on a single server.

Installation and Setup

Add this line to your project's Gemfile:

gem 'kitchen-localhost'

...and then execute:

$ bundle install

...or install it yourself as:

$ gem install kitchen-localhost


Just override one of the platforms in your Kitchen config to use this driver. That's it!

  name: vagrant

  name: chef_zero

  - name: ubuntu-14.04
  - name: centos-7.0
  - name: macosx-10.10
      name: localhost

  - name: default
      - recipe[something]

Optionally, you can configure the driver to leave behind Test Kitchen's temp directories when it does a kitchen destroy:

  name: localhost
  clean_up_on_destroy: false

This can be useful if, for example, you have a CI system that's slow to install gems and you want to have it cache Busser + its plugins.


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. bundle install
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Ensure your feature has tests and rake passes
  5. Commit your changes (git commit -am 'Added some feature')
  6. Push to the branch (git push origin my-new-feature)
  7. Create new Pull Request
  8. Keep an eye on the PR and ensure the CI build passes

New features that have no tests and changes that cause the CI build to fail will not be merged


Created and maintained by Jonathan Hartman ([email protected])


Apache 2.0 (see LICENSE)