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


Implementation is the process of business analysis, system customization, server installation and configuration, user training and support, with the aim of collecting data for analysis and decision making purposes. 

These documents describe how to implement OpenMRS.

  1. Getting Started with OpenMRS
  2. OpenMRS from Scratch
  3. Field Guide
  4. The EHSDI Training Course, section 202, which covers implementation

There is an "Openmrs Book" / Guide online as well:

Choosing OpenMRS

This should discuss how you define your problem, set goals and scope. Who are your users?  What do they want? Do you have funding for equipment and support? What do you want? Will OpenMRS fit your needs? Should add a checklist and/or grid with features. (copy from Field Guide?)


Once you have chosen OpenMRS, what are the preliminary steps.

Initial Setup - From Beginning to Launch

Ongoing Support - Launch and Beyond

Reporting and Data Analysis

  • The Reporting Module is the most popular tool for generating reports.  It's extensively documented; see the module's project page. 
  • AMPATH exports data through SQL for analysis with other tools
  • De-identifying data to protect patient privacy
    • Data policy (IRB, country and/or organization restrictions, encryption)
  • Data analysis in OpenMRS
    • There is a proof of concept project to use  Pentaho for analysis


  • OpenMRS concepts can be mapped to medical coding standards and other terminology sets, such as ICD-10, SNOMED, etc. Read more about mapping.  



  1. Is "User Administration" about administering users or users administering the system?

    • Customizing the Look and Feel (tm)
    • Server management/best practices
    • Performance tuning
  2. Here's another pass.

    Planning -

    Initial Setup - from Beginning to Launch

    Ongoing Support - launch and beyond

    • System Maintenance
      •       Server Management
      •       Performance Tuning
      •       Backups
      •       Replication Options
        • MySQL replication
        • Sync Module
      •       Upgrading OpenMRS
      •       Updating Modules 
    • User Administration
      • Adding users
      • Disabling Logins
      • Setting Role Permissions
    • Concept Administration
      • Exporting concepts with metadata
    • Form Administration
    • Data Administration
    • Patient Administration
    • Encounter Administration
    • Location Administration
    • Observation Administration
    • Order Administration

    Reporting and Data Analysis

    1. This is quite a good stab at it, Janet.  I like this a lot, and am tempted to just adopt this as-is as our "outline".  Thanks!

  3. I'd like to see profiles of existing deployments (or "types" of deployments).

    • Org structure
    • User Profiles
    • Health Centre workflows
    • OpenMRS configuration settings
    • OpenMRS modules in use
    • OpenMRS Concept dictionary
    • OpenMRS Forms in use
    • Reports...?

    So that as an implementer I can look at the different types of sites and choose which one my health centre most closely resemebles then focus on mimicking it.