Reports Configurations (docker)

Bahmni/reports image runs bahmni reporting service which can generate reports from different application databases of Bahmni such as OpenMRS, OpenELIS, Odoo. These reports can be configured from config service of Bahmni. More about reports configuration can be found here. The docker image is built and published using Github actions from bahmni-reports repository.

Environments Configurations

Variable Name


Variable Name



This value specifies which image version needs to be used for reports service. List of tags can be found at bahmni/reports - Tags .


Database name for Reports


Username of Reports Database


Password of Reports Database

Adding Custom Reports

  1. First volume mount your configuration folder as mentioned here.

  2. You can start reports by running docker-compose up -d reports.

  3. Now, you can add/modify reports by editing the reports.json file at openmrs/apps/reports/ in your config folder.

  4. When you want to add custom sql files, add the sql file to openmrs/apps/reports/sql directory in config folder and in sqlPath attribute use value as /etc/bahmni_config/openmrs/apps/reports/sql/<filname.sql>

  5. The new report will be visible on refresh of the browser.


The Bahmni documentation is licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)