Installation

Delve currently isn't packaged for any operating systems, so you'll have to use a "from-source" installation.

Running from source

Clone from git

First, check out the Delve source code using git:

git clone https://github.com/GregSutcliffe/delve.git
cd delve

(Optional) You can switch to a specific release after cloning using:

git checkout <tag>

Database

Now set up your choice of database. As normal for Rails apps, you can use SQLite, MySQL, or PostgreSQL. The configuration is already set up to use SQLite, but if you wish to use one of the other databases, you should setup the host/port/db/user/password in config/database.yml and add the appropriate gem in Gemfile. For example:

# Gemfile
gem 'pg'
# config/database.yml
production:
  adapter: postgresql
  database: delve
  host: delve
  username: delve
  password: secret

Setting up the database is left as an excerise for the reader :)

Configuration

Eventually the choice of storage location will be configurable. For now you must use public/scans so create this directory

mkdir ./public/scans

Now you need to install the gems, using bundler

gem install bundler
bundle install
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake assets:precompile

Start it up

You should be good to go! The thin gem is included, so starting Rails as normal will use Thin. Simply execute

bundle exec rails s -e production

You can add -d to daemonize Delve, or you could use Passenger with Nginx/Apache (which is also left as a reader exercise).

You should now have Delve running on port 3000! Try it in your web browser - if you do, proceed to the User Guide. If not, check out the Troubleshooting guide.