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

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.

  • No labels