This is an abbreviated version of the guide seen here and is used in the video here.

This file is available for download here.

This guide is a reference for users to copy and paste from when installing OpenMRS on OpenShift.








Connecting to the server: rhc ssh $OPENSHIFT_APP_NAME


Add a DIY cartridge.

Add MySQL cartridge to the previously created one (OpenShift console -> cartridge -> Databases -> Add MySQL).


Clone the repository: 

Use link from OPENSHIFT Dashboard

git clone <link>


Move to the resulting directory:



Deploy custom Tomcat (Custom here means not the default one for OpenShift. In fact, this variant is upstream.)

git remote add tomcat-upstream -m master git://

git pull -s recursive -X theirs tomcat-upstream master

git push


Deploy OpenMRS to server:

Download the app archive (version specified here is the most recent one by the time of writing) into tomcat webapps directory:


Move it to this directory: diy/tomcat/webapps/openmrs.war


git add diy/tomcat/webapps/openmrs.war

git commit -m “Deployed OpenMRS Platform 1.10.1”

git push


Configure OpenMRS on low level:

ssh to the server

using rhc command line tools: rhc ssh $OPENSHIFT_APP_NAME


echo "/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs/" > .env/user_vars/OPENMRS_RUNTIME_PROPERTIES_FILE


Exit the server

Set proper app data directory (default is ~/.OpenMRS; these commands are to be run in the git repository associated with your cartridge):

Make the folder openmrs inside the diy folder


echo “” > diy/openmrs/


Add MySQL configuration to OpenMRS config:

Copy paste this into the file diy/openmrs/ (delete the quotation marks that are there)



### Database connection properties





Commit and push the changes:

git add diy/openmrs/

git commit -m “Configured OpenMRS”

git push


Proceed to high-level OpenMRS configuration via browser. You should not select 'Simple' as type of installation as it assumes having MySQL root, etc.