quickstart dev setup for OpenMRS with virtualization
Vim script Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Quickstart development setup for OpenMRS via virtualization so that the host computer doesn’t get mucked up.
For express setup based on a snapshotted VM image please use branch express-setup.
If you are on a Windows machine, please also use branch express-setup.


VirtualBox, https://www.virtualbox.org/wiki/Downloads
Vagrant, http://downloads.vagrantup.com/
Ansible, http://www.ansibleworks.com/docs/intro_installation.html

Note: OSX users will want to use the dmg’s for VirtualBox and Vagrant and the pip installation method for ansible
Note: Windows users will not need to download ansible.

Happy Path Usage Instructions

[install dependencies]
git clone https://github.com/cpschuster/OpenMRS-dev-setup
cd OpenMRS-dev-setup
[If Windows user] git checkout windows
mkdir projects
vagrant up (takes ~30 minutes)
vagrant ssh
[in guest terminal] cd Projects/OpenMRS/webapp/
[in guest terminal] mvn clean install (upon any local dev changes — not needed the first time)
[in guest terminal] sudo mvn jetty:run
[in host browser] http://localhost:8080/openmrs/
[in host browser] During OpenMRS installation, mysql root password is root_password
[in host browser] After OpenMRS installation, log in with admin/Admin123
[in host machine] Create Eclipse workspace over OpenMRS-dev-setup/projects. Take note that Java versions etc. will need to match what’s on the VM.

Setting up git + workflow tutorial

Do this after you’ve set up your environment.
Go through the steps on the wiki page: https://github.com/hypotext/OpenMRS-dev-setup/wiki/Setting-up-git,-plus-workflow-tutorial

Then go through these steps to get the webapp up and running: https://github.com/hypotext/OpenMRS-dev-setup/wiki/Running-the-OpenMRS-webapp-and-viewing-changes-in-code