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.
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
git clone https://github.com/cpschuster/OpenMRS-dev-setup
[If Windows user] git checkout windows
vagrant up (takes ~30 minutes)
[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