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

The easiest way to try out an OpenMRS 2.x release is by downloading an OpenMRS 2.x standalone.

If you want to install for production use, you will need to install the WAR plus modules.

Installing from WAR and Modules

An OpenMRS 2.x release consists of:

  1. An OpenMRS Platform WAR file that you deploy using Tomcat or another servlet container. (For example OpenMRS 2.2 uses the OpenMRS Platform 1.11.2 WAR)
  2. A collection of OpenMRS Modules that together make up the OpenMRS 2.x user interface.

At, for a specific release of OpenMRS, you can find one link to the WAR file, and second link to Modules & Data.

The first step is to ensure that all prerequisites (e.g. Java, MySQL, Tomcat) are installed. (To Do: link to documentation of prerequisites.)

Install the OpenMRS Platform WAR

Next, you deploy the OpenMRS Platform WAR in Tomcat (or another servlet container). Next, visit the deployed URL (e.g. http://localhost:8080/openmrs) and you should see a first-time setup wizard. (To Do: screenshots).

Go through the first-time setup, making sure you do not install demo data.

Once the wizard has configured the database, you should see a login screen. You don't need to log in – at this point you have installed the OpenMRS platform, and you want to install all the modules, which you will do from outside of OpenMRS.

Install OpenMRS 2.x Modules

Next, you need to find your OpenMRS modules folder is. Typically this will be the "modules" folder next to the "" file that was created by the first-time setup wizard.

Once you have found this folder, you want to copy all of the OMOD files from the "OpenMRS 2.x Modules and Data" zip (downloaded from into your modules folder.

Next, restart Tomcat.

This time, the OpenMRS application will take an unusually long time to, since a lot of reference data is being created for the first time. You can watch progress in tomcat's logs. Finally, when you visit the deployed URL you should see a login screen that looks different from what you saw after installing only the Platform. (It should look like the one on


  • No labels


  1. Hi Team,

    As per this process i have setup every thing i have download  OpenMRS Platform 1.11.2 war and added all modules in appdata folder. And when i am trying to run this application tomcat server will get down first. so what is the problem in it. am i set any properties ? and when i try continuously server will get up some i am was able to login in to application but if i trying to added patient data its got added but its throws some exception like telephone number ........ like this kindly exception i am facing so kindly guide me a like or any other way to solve or avoid this kindly of issues.




    1. Hi Prabhakar. You're welcome to ask your question here, but for your reference: generally most questions will get answered more quickly using the method you already did at Ask OpenMRS.

      1. Oh ok thanks you michael