Development Setup

Local Setup

1. Install Docker CE for your OS. Also install Fabric via pip install fabric

2. Create .env file with the reference of.env.exampleor receive .env file from your team member

3. Runfab up

4. Go to http://127.0.0.1:8082/ to check if the frontend / polymer is running. The Django app is running under ​http://127.0.0.1:8082/api/

5. Login to backend using fab ssh:backedand create admin withpython manage.py createsuperuser

6. To prepare data, load fixtures and run all required commands from the chapter Fixtures and Management Commands.

7. Go to http://127.0.0.1:8082/api/admin/ login with your credentials

8. Important! Users created with superuser command will not be associated with any country, which could lead to the frontend issues. You need to assign the country manually in the admin panel from the user edit page.

9. Open ​http://127.0.0.1:8082/fm/ in your browser to see the frontend interface.

Helpful Commands

Here are some useful docker tips:

display all containers:

$ docker ps

ssh into running django_api container

$ fab ssh:backend

stop all containers

$ fab stop_docker_containers

cleanup docker system: remove all inactive containers

$ docker system prune