README.md

Tunnistamo

Set up with Docker

1. Create a local_settings.py file in the project folder:

   • use the local_settings.py.docker.template
   • set DEBUG the way you need it

2. Run docker-compose up

3. Run migrations if needed:

   • docker exec tunnistamo-backend python manage.py migrate

4. Create superuser if needed:

   • docker exec -it tunnistamo-backend python manage.py createsuperuser

5. Run the server:

   • docker exec tunnistamo-backend python manage.py runserver 0:8000

The project is now running at localhost:8000

Set up w/o Docker

Prerequisites

Tunnistamo runs on postresql. Install the server on Debian based systems with:

apt install postgresql

Then create a postgres user and db as root:

createuser <your username>
createdb -O <your username> tunnistamo

Installing

Clone the repo:

git clone https://github.com/City-of-Helsinki/tunnistamo.git
cd tunnistamo

Initiate a virtualenv and install the Python requirements:

pyenv virtualenv 3.6.2 tunnistamo-env
pyenv local tunnistamo-env
pip install -r requirements.txt

You may choose some other Python version to install but currently Tunnistamo requires Python 3.

Create local_settings.py in the repo base dir containing the following line:

DEBUG = True

In case you want to modify the default database configurations, you may also modify them in the same file by adding these lines:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'custom_database',
        'USER': 'custom_user',
        'PASSWORD': 'your_password',
        'HOST': '127.0.0.1',
    }
}

Run migrations:

python manage.py migrate

Create admin user:

python manage.py createsuperuser

Run dev server:

python manage.py runserver

and login to http://127.0.0.1:8000/ using the admin user credentials.

To access the themed views you also need to install npm and run npm install at the project root.

Developing

Outdated Python dependencies

Tunnistamo uses prequ – a fork of pip-tools – to manage the Python dependencies. prequ can handle -e style dependencies (git URLs) in the requirements files.

Update the requirements with:

pip install prequ
rm requirements.txt
prequ update

License

This project is licensed under the MIT License – see the LICENSE file for details.