Awesome Open Source
Awesome Open Source


WARNING: This project is no longer maintained. You should use Berkshelf instead.

A Vagrant plugin to install Chef cookbooks using Librarian-Chef.


  • Vagrant version 1.2.0 or greater.


vagrant plugin install vagrant-librarian-chef


Vagrant will automatically run Librarian-Chef before any provisioning step, so simply set up your Cheffile as you normally would.

You may specify the subdirectory within which to run librarian-chef using the librarian_chef.cheffile_dir config key. Please keep in mind that you will need to explicitly set the cookbooks_path in the :chef_solo provisioner:

Vagrant.configure("2") do |config|

  config.librarian_chef.cheffile_dir = "chef"

  config.vm.provision :chef_solo do |chef|
    chef.cookbooks_path = "chef/cookbooks"



Librarian-Chef can be configured normally via configuration file at .librarian/chef/config. Again, if you change the path where cookbooks are installed by Librarian-Chef, make sure your Vagrantfile is updated to tell Vagrant's Chef provisioner where to look for them via the cookbooks_path attribute.

If you want to programmtically disable the plugin without uninstalling it, set the enabled attribute to false:

config.librarian_chef.enabled = false


Vagrant 1.5.0 or greater is required.

bundle exec vagrant up


Thank you to @thegcat and other contributors for their work on vagrant-librarian, an earlier version of this functionality for Vagrant 1.0.x and the original Librarian gem with integrated Librarian-Chef.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
ruby (12,196
deprecated (171
vagrant (149
unmaintained (55

Find Open Source By Browsing 7,000 Topics Across 59 Categories