Admin UI Module


This module consists of administration tools for the OpenMRS Reference Application (see resources). The Reference Application is an implementation of OpenMRS used to add new functionality as small apps in a similar fashion to mobile applications. The Reference Application comes with a number of apps out of the box. Currently, this application provides apps, which enable you to:

  • register patients
  • start and end visits
  • list patients with active visits
  • admit/transfer/discharge patients
  • take clinical notes
  • capture patient vitals
  • display patient summary and visit history.
  • capture allergies
  • Enter forms from the patient dashboard

The Admin UI Module is written using the UI framework (see resources), and some pages are written with Groovy Server Page technology being backed up by controllers while other pages are written using angular and communicating with the server via the REST API provided by the web services module. With the Admin UI Module, the user has access to the “Configure Metadata” app.

The project tree is set up as follows:

apiJava and resource files for building the java api jar file. It also contains the message resource bundles files for translation and the moduleApplicationContext.xml file
omodFiles for the web layer reside in this directory like GSPs, html, CSS, Javascript files etc. It also contains the apps, extensions, config.xml and the webModuleApplicationContext.xml file.
pom.xmlThe main maven file used to build and package the .omod file

OpenMRS Requirement

  • Requires OpenMRS platform 1.11.4
  • Requires mySQL 5.6 installed


  • The Admin UI is included with the download of the Reference Application. You can find the instructions and installer by navigating here and downloading the Reference Application 2.8.0.
  • You can also manually upload the OMOD file which can be downloaded here. In-depth instructions on uploading the OMOD file can be found here.