OpenMRS 2.x Standalone Installation instructions - For Dummies version

These instructions will help you install OpenMRS Reference Application 2.x.

Step-by-step Installation Guide


The OpenMRS Reference Application standalone requires your system to have a few basic things:

  1. A web browser. Download and install Mozilla Firefox or Google Chrome. OpenMRS works fine on Safari, but we wouldn’t recommend that you use Internet Explorer.
  2. Java. You must have Java Runtime Environment or Java Development Kit 1.8. If you don't have Java 8 installed, follow these instructions for Oracle's Java (recommended).

Verify you have Java 1.8+ installed by opening a terminal and typing the command:

java -v

If you are using more than one version of Java on your machine, consider using jenv, a handy utility for managing and easily switching between java versions.

If you are a Windows user you can follow these instructions here to find out which versions of Java are installed on your computer.

1. Download the OpenMRS Standalone

Go to and download the most recent version – e.g., “Reference Application 2.6.1 Standalone Edition”.

2. Unzip the Folder

When you open the unzipped folder you will see that everything is available and prepacked with a demo database of patients as well.

3. Run the Standalone

You should be able to start the OpenMRS Standalone by double-clicking on the openmrs-standalone.jar file.

Alternatively, from the command line, navigate to the folder containing the openmrs-standalone.jar file and you can start OpenMRS with the command:

java -jar openmrs-standalone.jar

See the OpenMRS Standalone page for more details on optional command line parameters.