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.








Add a DIY cartridge.

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

Prepare to change the cartridge:

Clone its repository: 

git clone ssh://$OPENSHIFT_APP_UUID@$OPENSHIFT_APP_DNS/~/git/openmrs.git/

Move to the resulting directory:



Connect to the server (second text box on dashboard)

echo <variable name (refer to the top of the document)>


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:

curl -L -o 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

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):

mkdir diy/openmrs

echo "application_data_directory=/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs" > diy/openmrs/

Add MySQL configuration to OpenMRS config:

echo "### Database connection properties



connection.url=jdbc:mysql://$OPENSHIFT_MYSQL_DB_HOST:$OPENSHIFT_MYSQL_DB_PORT/$OPENSHIFT_APP_NAME?autoReconnect=true" >> diy/openmrs/


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