berkshelf 0,0,1,0,0,0,0,1 travis-ci ruby Rubygems

A Chef Cookbook manager

2 years after


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 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


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.

Related Repositories



A Vagrant plugin to add Berkshelf integration to the Chef provisioners ...



Berkshelf dependency API server ...



A oh-my-zsh plugin for berkshelf command completion. ...



A Chef cookbook to install a Berkshelf API server ...



A boostrapped setup for Laravel 4.0.x with Berkshelf and Vagrant ...

Top Contributors

reset sethvargo capoferro justincampbell ivey erikh charlesjohnson lamont-granquist thommay jkeiser tyler-ball temujin9 mryan43 KAllan357 jossy danielsdeleo jasondunsmore someara cjerdonek chrisroberts quodlibetor mwrock rchekaluk andrewGarson tylercloke chr4 tknerr punkle hnakamur keiths-osc


-   v5.1.0 zip tar
-   v5.0.0 zip tar
-   v4.3.5 zip tar
-   v4.3.4 zip tar
-   v4.3.3 zip tar
-   v4.3.2 zip tar
-   v4.3.1 zip tar
-   v4.3.0 zip tar
-   v4.2.3 zip tar
-   v4.2.2 zip tar
-   v4.2.1 zip tar
-   v4.2.0 zip tar
-   v4.1.1 zip tar
-   v4.1.0 zip tar
-   v4.0.1 zip tar
-   v4.0.0 zip tar
-   v3.3.0 zip tar
-   v3.2.4 zip tar
-   v3.2.3 zip tar
-   v3.2.2 zip tar
-   v3.2.1 zip tar
-   v3.2.0 zip tar
-   v3.1.5 zip tar
-   v3.1.4 zip tar
-   v3.1.3 zip tar
-   v3.1.2 zip tar
-   v3.1.1 zip tar
-   v3.1.0 zip tar
-   v3.0.1 zip tar
-   v3.0.0 zip tar