Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
84 lines (50 sloc) 2.06 KB

Tracker for Lost in the Darkness



I recommend using virtualenv, but nothing prevents you installing it into the root system


When installing this package, it will build the MySQL and Postgres clients. So you'll need the necessary headers, plus gcc on your machine.

For Ubuntu, run the following:

sudo apt-get install libmysqlclient-dev libpq-dev python-dev \

Installation procedure

  • Download the latest package from I recommend using the latest tagged version, but if you want bleeding edge, you may also download the "master" branch.

  • untar the package:

    tar xzf exhuma-lost-tracker-<version number+hash>.tar.gz
  • enter the folder:

    cd exhuma-lost-tracker-<version number+hash>

When not using virtualenv, you may skip this section


If you don't have virtualenv, run the following:

sudo apt-get install python-setuptools && easy_install virtualenv

  • create a virtualenv:

    virtualenv --no-site-packages /path/to/your/env
  • activate the environment:

    source /path/to/your/env/bin/activate

Without virtualenv

  • run the installer:

    python install

Database initialisation

To initialise the database run the following commands:

# export LOST_TRACKER_SETTINGS="/tmp/my/conf/"
# ./env/bin/alembic upgrade head


Configuration is handled using default Python script files. Currently the only configuration variable is DB_DSN representing the database connection string.

An example config file could be:

DB_DSN = 'postgres://user:passwd@localhost/dbname'

The file is only read by setting an environment variable called LOST_TRACKER_SETTINGS pointing to the file. For example:

export LOST_TRACKER_SETTINGS="/tmp/my/conf/"
./env/bin/python lost_tracker/