Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Please note, this is a contributed module from community. Bahmni, as of v0.92, does not bundle/package this as part of it distribution. Please contact "Possible Health" team for additional information. 


  1. Download and install dhis-integration rpm from (or build latest yourself from here:

    Code Block
    yum install dhis-integration-1.0-1.noarch.rpm

  2. Update the properties file for DHIS2 integration app, located at '/etc/dhis-integration/dhis-integration.yml', with right configuration.

    openmrs.root.urlUrl to access Openmrs servicehttp://localhost:8050/openmrs/ws/rest/v1
    bahmni.login.urlWhen user isn't logged in, then user is redirected to this url.

    reports.urlBahmni reports url. Used for downloading reports.

    This file contains configurations of DHIS2 reports.

    dhis.config.directoryThis folder contains DHIS2 integration configurations program wise./var/www/bahmni_config/dhis2/
    dhis.urlThe DHIS2 government server instance url.

    Ex. 1:

    Ex. 2:

    Note that the url could be at domain or ip address level (ex1) or could be at a specific path(ex2)

    dhis.userThe username to access DHIS2 instance.


    dhis.passwordThe password for the DHIS2 user.


    openmrs.db.urlMysql connection url to access "openmrs" database. Set valid user and password in the url.


    submission.audit.folderAll DHIS2 submissions are stored in this directory. Ensure the directory exists and "bahmni" user has access to it, or configure a different directory.


    server.portServer config. Port for server to listen to.


    server.context-pathServer config. Mapping incoming requests.


    log4j.config.fileServer config. Properties file for logger of dhis-integration server.

  3. Download and place the ssl.conf file.

    Code Block
    cd /etc/httpd/conf.d/

  4. Configure Bahmni landing page to show DHIS2 integration app.
    Insert the following in "/var/www/bahmni_config/openmrs/apps/home/extension.json" file

    Code Block
    "possible_dhis_2_integration": {
    	"id": "possible.dhis2Integration",
    	"extensionPointId": "org.bahmni.home.dashboard",
    	"type": "link",
    	"label": "DHIS2 integration",
    	"url": "/dhis-integration/index.html",
    	"icon": "fa-book",
    	"order": 11,
    	"requiredPrivilege": "app:reports"

  5. Ensure Bahmni reports service is installed and running successfully.

    Code Block
    service bahmni-reports status ##should be running

  6. Restart ssl and dhis-integration services.

    Code Block
    service httpd restart
    service dhis-integration restart

    Now the DHIS2 integration app is available on landing screen, given that the user has reporting privileges.


  1. Access the DHIS2 government server in your browser.
  2. Open data entry apps and select appropriate organisation and location.
  3. Once the data entry forms are visible, click on the input boxes where you enter the data.
  4. Right click on the input box and select "Inspect" from the options.
  5. Copy the Id of the html element from window (See image), it would look like the following string: "kSnqP4GPOsQ-kdsirVNKdhm-val".
  6. This string is in the format of "dataElementId - categoryOptionComboId - ...."
  7. These dataElementId and categoryOptionComboId need to be used in DHIS2 configuration file. Refer the below image.