A Chef Cookbook manager
Ruby Cucumber HTML
Latest commit 03b4384 Oct 11, 2016 @thommay thommay committed on GitHub Merge pull request #1621 from tkling/community-site-error-message
Community site error message missing remote cookbook site URI



Gem Version Build Status

Manage a Cookbook or an Application's Cookbook dependencies


Berkshelf is now included as part of the Chef-DK. This is fastest, easiest, and the recommended installation method for getting up and running with Berkshelf.

note: You may need to uninstall the Berkshelf gem especially if you are using a Ruby version manager you may need to uninstall all Berkshelf gems from each Ruby installation.

From Rubygems

If you are a developer or you prefer to install from Rubygems, we've got you covered.

Add Berkshelf to your repository's Gemfile:

gem 'berkshelf'

Or run it as a standalone:

$ gem install berkshelf


See berkshelf.com for up-to-date usage instructions.

Supported Platforms

Berkshelf is tested and supported on Ruby 2.2 and 2.3.


Berkshelf will search in specific locations for a configuration file. In order:


You are encouraged to keep project-specific configuration in the $PWD/.berkshelf directory. A default configuration file is generated for you, but you can update the values to suit your needs.

Shell Completion


Please see Plugins page for more information.

Getting Help

  • If you have an issue: report it on the issue tracker
  • If you have a question: visit the #chef or #berkshelf channel on irc.freenode.net


The Berkshelf Core Team

Thank you to all of our Contributors, testers, and users.

If you'd like to contribute, please see our contribution guidelines first.