Getting Started

First, you’ll need to make sure you have Ruby, Rake, git, Capistrano, HighLine, sqlite3, and the sqlite3-ruby bindings installed.

Installation Required Software Packages

Here is an attempt to collect how to install different required software packages. Remember TIMTOWDI and YMMV.

Installing Ruby

http://www.ruby-lang.org/en/downloads/

Installing Git

http://git.or.cz/gitwiki/Installation

Installing SQLite3

http://mislav.uniqpath.com/rails/install-sqlite3/

Installing Gems (Rake, Capistrano, Highline, Sqlite3-Ruby)

Windows

gem install rake capistrano highline sqlite3-ruby

Mac and Linux

sudo gem install rake capistrano highline sqlite3-ruby

After Installing the Required Software Packages

Once you’ve got that done:

• type “cap local externals:setup”. (This requires that you have git installed.) This will download and setup local copies of all the plugins and frameworks that BucketWise depends on.
• type “rake db:schema:load”. This will set up your database (using sqlite3 by default).
• type “rake user:create”. (This requires the HighLine gem.) This will prompt you for credentials for your first BucketWise user. Note the id of the newly created user.
• type “rake subscription:create USER_ID=n” (where ‘n’ is the user-id from the previous step). This will create a new “subscription” (a container for a related set of accounting information).
• type “script/server”, and then point your web-browser at http://localhost:3000 to begin using BucketWise.

Obviously, this only gets BucketWise running on your local computer. Installing it on a remote server is left as an exercise for the reader (though it’s really not hard; perhaps I’ll blog about my own setup eventually.)