| Under Development Chef 0.8.0 is still under active development as Opscode prepares to release it, tentatively scheduled for Feb 28, 2010. These instructions are considered deprecated, and the instructions on Installing Chef from HEAD should be used to install in-development versions of Chef. |
System RequirementsPlatformChef .8 is known to run on the following platforms. Noted versions or newer are recommended to ensure that dependencies build or install.
RubyChef is written in Ruby, so you need to have Ruby installed. Ruby 1.8.6 or 1.8.7 with SSL bindings. Chef is known to work with Ruby 1.8.5, but there are some compatibility issues; upgrading is advised. |
Chef Server Dependencies
Installing Chef from RubyGems will also install its Ruby dependencies.
Installing Chef from platform-specific packages will install the Ruby dependencies, and the non-Ruby dependencies through the platform's dependency handling. Some of the Ruby dependencies are packaged in the platform distributions, or packaged by the maintainers of the Chef packages.
Client/Solo
Libraries/programs required for chef-client or chef-solo.
Gems written and provided by Opscode:
- mixlibs (-cli, -config, -log, -authentication)
- ohai
Gems available from Opscode, and provided by:
- deep_merge
- moneta
Gems available from RubyForge:
- bunny
- json
- erubis
- extlib (0.9.13?)
- amqp
- thor (0.12.2?)
- ruby-hmac
In addition to the client dependencies above, the chef-server requires:
- merb (-core, -assets, -haml, -helpers, -slices, -param-protection)
- haml
- coderay
- thin
- uuidtools
Non-Ruby dependency:
- CouchDB (0.9.1-0.10+)
For ease of installation, we recommend using a platform for the Chef Server that has CouchDB 0.9.0+ available as a package.
- RabbitMQ (1.6+)
For ease of installation, we recommend using a platform for the Chef Server that has RabbitMQ 1.6+ as avialable as a package.
For ease of installation; this package is provided by Opscode.
For ease of installation, we recommend using a platform for Chef Server that has Java 6+ available as a package.
Preparation and Installation
| Chef .8 Chef .8 is currently still in testing and is considered alpha quality; it is not suggested to use in a production environment at this time. |
The following sections describe how to prepare your system(s) to install Chef .8 alpha on Ubuntu Karmic Koala (9.10); other distributions may vary slightly in instructions
From git
- Enable multiverse so you can get java.
- Run apt-get update
- Grab Ruby and the regular dependencies
- Add the Opscode Gem Repository to catch deep_merge, ohai and other various dependencies.
- Grab the last remaining dependencies
- Grab the source code from Github
| ohai You can grab Ohai from github and use the latest version of that also; however it is not required. |
- Install Chef and it's dependencies
- Bootstrap Chef Server
1. create chef.json with the following contents (runit is the suggested method)
2. create solo.rb with the following contents
3. clone the cookbooks off of github
4. Bootstrap Chef-server