Opscode
Home     Cookbooks     Blog     GitHub     Tickets 

Installation with RubyGems

This page describes the process of getting RubyGems installed from source if it isn't already on the system, and also installing the Chef and Ohai gems.

Install Ruby

If you don't already have Ruby, go back to the Installation page and see install requirements for platform-specific instructions.

Install RubyGems from Source


We prefer to install RubyGems from source rather than use the OS-provided version (if any), as it is cross platform, so we know what to expect.

Install RubyGems

For Debian and Ubuntu users, see the Debian Position on RubyGems. If you prefer to install Chef from APT packages, you can use the Opscode APT repository to install Chef on Debian or Ubuntu with APT.

$PATH Issues

If you use an OS-provided RubyGems package instead of installing from source, you may need to add the path where it puts RubyGem-installed programs to your system's PATH, otherwise Chef may not start/work properly. If you're not sure what path to add, check gem env for "EXECUTABLE DIRECTORY".

Configure Gem Sources


The Opscode Gem releases are available via RubyGems. As of RubyGems 1.3.6, this is the default source and you don't need to do anything. If you're running an older version, the default source is http://gems.rubyforge.org/; it has been changed by the Ruby community to point to rubygems.org for the foreseeable future and you don't need to do anything. However, it is probably a good idea to make sure that your sources are updated:

Install Chef Gem


Now we'll install the Chef RubyGem. This also installs Chef's dependencies.

Install Chef

Set up Chef


Now that you have Chef installed, you're ready to bootstrap Chef.

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Copyright © 2009 Opscode, Inc. All Rights Reserved.