Berkshelf

Manage a Cookbook or an Application's Cookbook dependencies

Installation

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

Usage

See docs.chef.io for up-to-date usage instructions.

Supported Platforms

Berkshelf is tested and supported on Ruby 2.2 and 2.3.

Configuration

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

$PWD/.berkshelf/config.json
~/.berkshelf/config.json

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

• Bash
• ZSH

Plugins

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

Authors

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.