Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS »
Discussion: OpenMRS Talk »
Real-Time: IRC Chat

Documentation

Skip to end of metadata
Go to start of metadata

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

Step-by-step Installation Guide

Requirements

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:


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 http://openmrs.org/download/ 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:

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