Keybox uses the SHA256 digest algorithm in its work and this was not available in OpenSSL until version 0.9.8. As a result, the ruby installation that runs keybox must be compiled against an OpenSSL library of 0.9.8 or greater.

Quick Installation

There are no prerequisites other than a basic ruby install that includes the OpenSSL libraries as part of the standard lib.

The simplest install for keybox is via rubygems:

    gem install keybox

Installing without gems

Keybox does not require any gems to operate from an end-user perspective so you can just download the .tgz or .zip file from Rubyforge and extract it into a directory.

    % tar zvf keybox-1.0.0.tgz
    % cd keybox-1.0.0
    % ./bin/keybox --help

Then to utilize it with non-standard locations for the config.yaml and database.yaml you would just use the command line options. So for instance, given the following:

  • ruby installed on the host machine
  • USB Drive mounted on /Volumes/MyData/
  • keybox on that drive under MyData/keybox-1.0.0

I could execute keybox against my portable setup with:

% cd /Volumes/MyData/keybox-1.0.0
% ./bin/keybox --config=./data/config.yaml --database=./data/database.yml