1. Clone the project from github (use -r to fetch submodules content)

git clone
  1. Install the git submodule for DATS JSON schemas (if did not clone recursively):

git submodule update --init
  1. Create and activate a virtual environment

  2. Move to the main directory and install required packages:

pip install -r requirements.txt
  1. The service uses PostgreSQL database for data storage. Install PostgreSQL following this tutorial.

  2. Configure database connection in

e.g. settings if running database on localhost, default port for PostgreSQL is 5432:

    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'database_name',
        'USER': 'user',
        'PASSWORD': 'password',
        'HOST': 'localhost',
        'PORT': '5432',
  1. From the main directory run (where the file located):

python makemigrations
python migrate
python runserver
  1. Development server runs at localhost:8000