Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Skeleton homebase for Ironfan and Chef -- use this to hold your clusters, cookbooks and stacks
Tree: 29c1d3ea4b

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
notes @ 44046c3

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 Infochimps Blog introducing the Infochimps Platform.

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)

To get started with Ironfan, clone the ironfan-homebase repo and follow the Installation Instructions. Please file all issues on Ironfan issues.


ironfan-homebase works together with the full Ironfan toolset:

Core Tools:

  • 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. It comes with ironfan-homebase.
  • 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.

Core Documentation:

  • ironfan wiki: High-level documentation and install instructions.
  • ironfan issues: Bugs or questions and feature requests for any part of the Ironfan toolset.
  • ironfan gem docs: Rdoc docs for Ironfan. __________________________________________________________________________

Getting started

Before you start, fork this repo, as you'll be personalizing it for your use.

Clone the repo and all of its submodules:

    git clone homebase
    cd homebase
    git submodule foreach git checkout master
    git submodule update --init

Now follow the detailed install notes in homebase/notes/

In the Install notes you'll notice the Git clone instructions again, we just want to make sure you're on the right track.

Something went wrong with that request. Please try again.