/
OpenMRS Standalone

OpenMRS Standalone

Nov 23, 2020

OpenMRS Standalone provides a simplified, all-inclusive installation option with both an embedded database and web server. You can have a local copy of OpenMRS running within minutes: simply download and expand the archive, and then run the extracted openmrs-standalone.jar file. Your browser will open a new instance of the OpenMRS system. For the OpenMRS Standalone -Reference Application 2.10.0 edition, the default username is "admin" and the default password is "Admin123". And for the OpenMRS Standalone - Platform 2.3.0 edition, the default username is "admin" and the default password is "test". OpenMRS Standalone is a great way to evaluate and explore OpenMRS capabilities. It may also be useful for small-scale production environments. At this time we are still developing operational experience with the standalone in production environments.

Since the embedded database & server are production-quality and the OpenMRS code is the same as our enterprise release, we have high expectations for the standalone. Before you choose the standalone, be aware that we are still gaining experience with this version in production environments.  If you have any questions or concerns, let us know through our mailing lists, Twitter (@openmrs), etc. We're listening!

FWIW, we have heard of more than 100 sites, which have successfully used the standalone version, in production, for a number of years. https://talk.openmrs.org/t/using-the-openmrs-standalone-version-in-production/17519

Installation

If you have no prior development experience there is a "For Dummies" version of the installation instructions (see child page), else continue with the instructions below

Step 1

Download and unzip the standalone file

Step 2

Just double click on the openmrs-standalone.jar file in that folder, or execute it as below:

java -jar openmrs-standalone.jar

 

OpenMRS will install itself the first time it is run.  The installer will offer an option to install demo data (demo concepts and/or patient data). 

Java version less than 1.8 installed, the standalone may fail to start. You can run the standalone with a specific version of Java by giving the full command line to the java executable. For example:

"c:\Program Files\java\jdk1.8.0_172\bin\java.exe" -jar openmrs-standalone.jar

 

 

See below for a list of command line options.

Do NOT delete or rename folders after decompressing the standalone package. They are used by the standalone jar file and it expects them to be in the exact locations where they already are.

 

 

Download

 OpenMRS Standalone

 

GUI Mode Options

Tomcat Port

This is the port at which to run Tomcat

MySQL Port

This is the port at which to run MySQL

File → Quit

This stops Tomcat and MySQL and then closes the application

File → Launch Browser

This opens the OpenMRS login page for the current web application context

File → Clear Output

This clears the output log in the user interface text area, but does not clear the log file written on the file system

Start

This button runs Tomcat, which will automatically start the MySQL database engine if it was not already running. For the embedded MySQL, the first connection automatically starts the MySQL engine

Stop

This button stops Tomcat and then also stops the MySQL database engine, without closing the application

 

Minimizing or maximizing the application window does not have any effect on the server. The Close window icon will stop the server (behaves as File → Quit) but will first ask you to confirm.

Command Line Mode Options

-commandline

Run from the commandline

-mysqlport

Use to override the MySQL port in the runtime properties file

-tomcatport

Use to override the Tomcat port in the runtime properties file

start

Use to start the server

stop

Use to stop the server

browser

Use to launch a new browser instance

-noninteractive

No prompting, installs demo data

-noninteractive -expert

No prompting, installs without demo data (just basic metadata)

-noninteractive -empty

No prompting, installs with an empty database

Authentication Information

After running the standalone jar, it will take you to the OpenMRS log in web page where you can log in with the following default username and password:

OpenMRS username: admin

OpenMRS password: Admin123 or test

The MySQL database has these credentials by default:

MySQL username: openmrs

MySQL password: randomly generated at initial startup. Look in openmrs-runtime.properties file under connection.password