Basic prerequisites:

bundle gem (sudo gem install bundle)

mysql (or postgresql?) with a database for DontLoseTrack!

memcached (if you want caching, or store openid nonces in memcache)

ruby (and rubygems)

pygments (for syntax highlighting)

make (GNU make)

Prerequisites for optimization:

To later optimize the static files, you'll need the following

node.js (nodejs)

Installation:

Grab a copy of DontLoseTrack

git clone git://github.com/bwalex/DontLoseTrack.git
cd DontLoseTrack
git checkout backbone

Grab the required ruby gems by running:

bundle install --without postgresql

if you plan on using mysql; or alternatively if you will be using postgresql:

bundle install --without mysql

Basic configuration:

Now copy over config/config.yml.example to config/config.yml and adjust to your liking. The ’optimized’ option should only be enabled if you follow the optimization section below. The ’silent’ setting silences the output of Rack, Sinatra, Rack::Cache and ActiveRecord (ActiveRecord is actually logged into database.log if ’silent’ is true).

OpenID can use both memcache and filesystem stores - an example for each is provided.

Caching requires memcache, but you can disable it by commenting out the whole cache: section.

For the database configuration, copy config/database.yml.example to config/database.yml and edit to match your configuration. It's a regular ActiveRecord style configuration file. Adjust adapter, user, password, host, database to match your configuration.

Change the port and the listen address in the unicorn.rb file. See unicorn documentation for more details.

Bootstrap:

Build templates and CSS files:

make tmpl css

Create database tables:

make db

Optimize (optional):

Generate optimized static files (minified and unified javascript, etc) by running:

make optimize

and setting

optimized: true

in the configuration file config/config.yml.

Run:

DontLoseTrack! depends on unicorn as an application server. It is possible to use a different one such as thin or rainbow by creating an appropriate config file for it that establishes and cleans the ActiveRecord connections (see unicorn.rb).

To run, type:

bundle exec unicorn -c unicorn.rb

Scheduled tasks:

DontLoseTrack! has some scheduled tasks (currently the external resource handling) that should be run from cron or similar.

The commands that have to be run are:

bundle exec rake tasks:extres

Updating:

To update, you should run:

git pull
bundle install --without (postgresql or mysql, see above)
make db
make tmpl css

If you are using optimization, you should also run:

make optimize