====== HOWTO: Deploy your Rails App onto your Brightbox for the first time ======

This covers the very basics of getting your Ruby on Rails application running on a Brightbox.

==== Step 1: Getting Ready ====

  - [[http://www.brightbox.co.uk/rails-hosting-pricing| order your Brightbox]]
  - Install the [[docs:gemv2:howto:installgem|Brightbox Gem]].
  - Prepare your [[docs:gemv2:howto:database|database access]].
  - Prepare your [[docs:gemv2:gem_dependencies|application gems]]

==== Step 2: Deploy ====

From the command line, run the ''deploy:initial'' Capistrano task:
<code>
  cap deploy:initial
</code>

==== Step 3: Use your app ====

You'll receive email notifications from Monit that your system is working. 

==== Job Done ====

From then on, when you want to deploy new changes, just use the ''deploy'' task, or if you need to run new migrations use the ''deploy:migrations'' task.

Many of the other tasks available are documented in [[docs:gemv2:capistrano]].  Lots more information about more advanced use of the Brightbox gem can be found in the [[docs:gemv2:start|user guide]].