===== Installation guides =====

Currently, installing Flapjack is pretty ghetto. It's distributed as a RubyGem, and has a heavy set of dependencies. 

Native packages are [[packaging_guide|in the works]], so please bear with us until a less bongtastic install procedure is available. 

If you would like to contribute packages for your operating system, please check out the [[packaging_guide|packaging guide]].

==== Ubuntu Hardy through RubyGems=====

=== Dependencies ===

Add the following lines to ''/etc/apt/sources.list.d/flapjack.list'':
<file>
deb http://ppa.launchpad.net/ubuntu-ruby-backports/ubuntu hardy main
deb http://ppa.launchpad.net/auxesis/ppa/ubuntu hardy main
</file>

Add GPG keys for the repos:
<code>
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 288BA53BCB7DA731
</code>

Update your package list:
<code>
sudo apt-get update 
</code>

Install Ruby dependencies:
<code>
sudo apt-get install build-essential libsqlite3-dev
</code>

Install rubygems + beanstalkd:
<code>
sudo apt-get install rubygems beanstalkd
</code>

To start beanstalkd, set ''ENABLED=1'' in ''/etc/default/beanstalkd''.

Start beanstalkd:
<code>
sudo /etc/init.d/beanstalkd start
</code>

=== Installation ===

Add the Gemcutter RubyGems server to your Gem sources:
<code>
sudo gem sources -a http://gemcutter.org
</code> 

Install the Flapjack gem:
<code>
sudo gem install flapjack
</code>

Then run the magic configuration script to set up init scripts:
<code>
sudo install-flapjack-systemwide
</code>

The script will prompt you if it wants to do anything destructive.