Skeleton homebase for Ironfan and Chef -- use this to hold your clusters, cookbooks and stacks
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
certificates made things match up pretty well with old homebase Feb 15, 2012
config Berksfile: adding community_cookbook capability, removing cookbooks m… Apr 15, 2013
data_bags made things match up pretty well with old homebase Feb 15, 2012
environments adding testing environment Feb 19, 2013
knife example-credentials: added testmonkey config Apr 11, 2013
notes @ 72d0d7e notes: updated to latest commit Jun 21, 2013
org_cookbooks Replacing submodule mess with Berkshelf-based cookbook management Nov 13, 2012
tasks Adding chef_config.rake from ironfan-pantry Nov 13, 2012
vagrants el_ridiculoso working, working on cookbooks consistency Feb 20, 2012
.chef Making local .chef (instead of ~/.chef) the default for homebases Nov 27, 2012
.gitignore Add .gitignore for bash completion script (cache dir) Oct 1, 2013
.rspec cluster_chef renamed to metachef: too confusing otherwise Dec 11, 2011
Gemfile.lock Updated Gems Aug 28, 2013
Guardfile license file Feb 16, 2012 Added notice about ruby 1.9+ version requirement Apr 16, 2012
Rakefile Rakefile: adding sync_environment to push_to_production Mar 25, 2013
chefignore adding a zookeeper demo cluster. Cleaned up some log statements. Jan 22, 2012

Ironfan-Homebase: Master Plans for a Scalable Architecture

Ironfan, the foundation of the Infochimps Platform, is an expressive toolset for constructing scalable, resilient architectures. It works in the cloud, in the data center, and on your laptop, and it makes your system diagram visible and inevitable. Inevitable systems coordinate automatically to interconnect, removing the hassle of manual configuration of connection points (and the associated danger of human error). For more information about Ironfan and the Infochimps Platform, visit

The Ironfan Homebase repository is the central home for orchestrating your architecture. It unifies:

  • Cookbooks, roles, and environments
  • Cluster descriptions
  • Your Chef and cloud credentials
  • Pantries (collections of cookbooks, roles and so forth)

Getting Started

To jump right into using Ironfan, follow our Installation Instructions. For an explanatory tour, check out our Web Walkthrough. Please file all issues on Ironfan Issues.


ironfan-homebase works together with the full Ironfan toolset:


  • ironfan-homebase: Centralizes the cookbooks, roles and clusters. A solid foundation for any Chef user.
  • ironfan gem: The core Ironfan models, and Knife plugins to orchestrate machines and coordinate truth among your homebase, cloud and chef server.
  • ironfan-pantry: Our collection of industrial-strength, cloud-ready recipes for Hadoop, HBase, Cassandra, Elasticsearch, Zabbix and more.
  • silverware cookbook: Helps you coordinate discovery of services ("list all the machines for awesome_webapp, that I might load balance them") and aspects ("list all components that write logs, that I might logrotate them, or that I might monitor the free space on their volumes"). Found within the ironfan-pantry.


Note: Ironfan is not compatible with Ruby 1.8. All versions later than 1.9.2-p136 should work fine.