Installing and configuring for development and testing


LTD Keeper requires Python 3.5.

You can get the application by cloning the Git repository:

git clone

Install the pre-requisites with pip: Install for development:

cd ltd-keeper
make install

LTD Keeper also uses SQLite in development and testing modes (any SQL server can be used in production).

Running Tests: pytest

You can invoke the pytest-based tests by running:

make test

Running for development: runserver

The ‘development’ configuration profile provides useful defaults for running an LTD Keeper instance locally (see

Run LTD Keeper in development mode via:

./ createdb
./ init
./ runserver

The createdb subcommand creates tables in a development database, and the init command seeds a default user. This default user has username user and password pass.

Once the development DB is prepared you can skip the createdb and init commands with later instantiations of runserver.