Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack


Page tree
Skip to end of metadata
Go to start of metadata

KenyaEMR can be installed in the following ways

KenyaEMR Installation environment is supported on both Ubuntu server and Ubuntu Desktop. The current KenyaEMR version (17.3.3)  can be installed on Ubuntu Version 16.04LTS and 18.04LTS respectively. 


  • OpenMRS 1.9.7 or higher
  • MySQL server 5.6
  • Java JDK 7 or higher
  • Tomcat 7 or 8
  • Web browser

If you do not have a suitable OpenMRS installation, then you can follow these instructions for Installing OpenMRS.

Don't install the demo data during OpenMRS installation as this will conflict with the metadata included in KenyaEMR. There should be no pre-existing data in OpenMRS prior to installation.

Installing from a distribution release

Some of the modules included in KenyaEMR require the scheduler.username and scheduler.password settings (formerly Global Properties from platform 1.8 downwards) to be set correctly. If these are not set correctly you may end up locked out of OpenMRS.

Distribution releases for KenyaEMR v12.x to 15.x are available from this Google Drive folder  while the latest version is available  in the KenyaHMIS GitHub link. Each release consists of two archives - the distro and the SQL dump containing the required concepts for that release.

  1. Stop Tomcat
  2. Extract the concepts SQL dump file from the SQL archive. Run this on the OpenMRS database which you will use with KenyaEMR
  3. Delete all existing .omods from your OpenMRS modules folder
  4. Extract the distro archive into your OpenMRS modules folder
  5. Start Tomcat


For implementers distributions, most of the above processes have been fairly automated for non-technical users.  During upgrades, the users only need to execute a simple shell script that deploys all the required dependencies in the correct places. Refer to user guide on KenyaEMR upgrade here.

  • No labels