Tanzania Health Data Repository

A Health Data Repository for data visualization for received from EMR systems through OpenHIM mediators.

Installation Instructions

1. Download and Install Python from https://www.python.org/ depending on your operating system.
2. Download and Install PostgreSQL from https://www.postgresql.org/ depending on your operating system.
3. Download and Install Git in your machine from https://git-scm.com/ depending on your operating system.
4. Clone the Tanzania Health Data Repository project from GitHub by running the command git clone [email protected]:SoftmedTanzania/tanzania-openhim-hdr.git
5. Install any text editor or IDE of your choice which runs terminal/bash on it i.e VS Code, Vim, PyCharm IDE.
6. After Python is successfully installed, open your terminal/bash then run pip3 install pipenv.
7. Then, upgrade pip by running the command python -m pip3 install –upgrade pip3
8. Navigate to the project folder then run the command pipenv shell to create and activate the Project Environment if does not exist.
9. After successful activation of the environment, run pipenv install to install all the packages needed for the project.
10. Run this command cp env.tx .env to copy the sample env and set the empty fields with your own ones.
11. Run this command to run the development server python manage.py runserver or ./manage.py runserver
12. Press CTRL+C for Linux and Windows or CMD+C for Mac to quit the running server.
13. Run ./manage.py migrate to migrate the authentication tables to the database which is the SQLite database by default.
14. Run ./manage.py createsuperuser to create the first admin user to the sysem.
15. Run the command python manage.py runserver or ./manage.py runserver to re-run the development server.
16. DONE!!!