Have you implemented OpenMRS? Please participate in the Implementation Site Survey. If you already have, thank you!
Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Clone / Pull the Reference Application's Distro repository.  https://github.com/openmrs/openmrs-distro-referenceapplication.git
  2. CD to the base directory of that clone.
  3. Run the command 'mvn clean package' to create a zip file of the war and omods for the Reference Application.

  4. Run the command 'vagrant up'

  5. Browse to http://localhost:8080/openmrs to run through the initial setup UI and test the application.
    1. Choose Advanced, and create a new database, without demo data.
    2. the mysql root password is Admin123
    access the application
  6. OPTIONAL: When done testing run 'vagrant halt' to stop the virtual machine.