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

Setting Up OpenMRS Developer Environment

(Windows 10)


Before building and compiling OpenMRS you must install the following dependencies:

Java JDK and JRE

                   Check for JDK by going to the command prompt and typing:

                             javac –version

                   The result should be:

                             javac 1.8.0_65

                   or whatever version you currently have


Check for JRE by going to the command prompt and typing:

                             java –version

The result should be similar to:

                            java version "1.8.0_65"

                           Java(TM) SE Runtime Environment (build 1.8.0_65-b17)

                          Java HotSpot(TM) 64-Bit Server VM (build 25.65-b01, mixed mode)



                OpenMRS requires at least java 1.6

The latest versions of JDK and JRE can be found at the following link:


For MySQL you must know MYSQL your root password or have a database ready with username and password



Eclipse IDE for Java EE Developers



Install Jetty plugin for Eclipse

                   In Eclipse go to Help>Install New Software



Select Add and enter the following:

                   Name: Jetty



Select Run JettyRun and click Next to install Jetty



Importing OpenMRS core from Git Hub through Eclipse

          In Eclipse go to File>Import>Git>Projects from Git



Select Clone URI and enter the following for the URI:




          Select all branches and select a destination for the files.

          After the OpenMRS files have been imported go to File > Import again in Eclipse and 

          select Maven > Existing Maven Projects



Select Browse and navigate to the openmrs-core folder.


Select all projects and click Finish to import openmrs-core into your Eclipse workspace.


Compiling OpenMRS

          From the command prompt navigate to the OpenMRS project directory

          Enter the following command:

                   mvn clean install



Run OpenMRS        

          Download the logic omod and place it in openmrs-core/puppet/modules


          From command prompt move to openmrs-core/webapp

          Run the following command:

                   mvn jetty:run

          Wait for:

                   [INFO] Started Jetty Server

          Open http://localhost:8080/openmrs