OpenMRS Reports OWA Configuration

You can configure Reports OWA to run the reports that are configured in OpenMRS reporting module.

  • Please follow this OpenMRS documentation to configure different type of reports in OpenMRS Reporting module.
  • You can watch this video on how to configure Reports.


Please note that each report in Reports OWA App takes only two input parameters i.e startDate and endDate and these should be added from openmrs reporting module. Adding more than two parameters or parameter other than Date Datatype is not supported in this version of reporting OWA app.

To configure Reports OWA app, we should have both owa.omod and reportingrest.omod. These omods will come out of box with 0.91v Bahmni installation. People who ever have 0.90v or previous version of Bahmni, they have to manually add the above omods to /opt/openmrs/modules path.

Steps to configure Reports OWA

  1. Download file from here (
  2. You may directly copy the downloaded zip file to /opt/openmrs/owa path and unzip the folder
  3. Alternatively, you may upload the zip file from OpenMRS UI.  OpenMRS => Administration => Open Web Apps Module => Manage Apps.

Please note that to upload/delete OWA from OpenMRS UI, property "module.allow_web_admin" value must be set to true in "/opt/openmrs/etc/" file

Now you will be able to access Reports OWA from OpenMRS UI.

Access Reports OWA from Bahmni Home page

To access directly from "Bahmni" you may create an extension. For example, If you would like to have this accessible from Home screen, add configuration in /var/www/bahmni_config/openmrs/apps/home/extension.json file like show below.

  "OpenMRSReports": {
    "id": "bahmni.openmrs.reports",
    "extensionPointId": "org.bahmni.home.dashboard",
    "type": "link",
    "translationKey": "OpenMRS Reports",
    "url": "/openmrs/owa/reports/index.html",
    "icon": "icon-bahmni-reports",
    "order": 15,
    "requiredPrivilege": "app:reports"


This module is available as a add-on to Bahmni, for versions 0.91 onwards. 

On this Page

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