Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS »
Discussion: OpenMRS Talk »
Real-Time: IRC Chat


Skip to end of metadata
Go to start of metadata

You can now proceed with the OpenMRS setup wizard. If this is the first time you are using OpenMRS, set the defaults as recommended below. Do not make additional changes.

Step 1

  • Under "Do you currently have an OpenMRS database installed that you would like to connect to?", select No.
  • Enter root as Username and openmrs as Password.
  • Select Continue.

Step 2

  • Under "Do you want to also add demo data to your database - openmrs?", select Yes.
  • Enter the following:
    • Username: root
    • Password: openmrs
  • Select Continue.

Step 3

  • Under "Do you want updates to the database to be automatically applied on started up when a new web application is deployed?", select Yes.
  • Select Continue. 

Step 4

  • Enter and re-enter a password that is at least 8 characters long and contains both upper and lower case letters along with a number.
  • Select Continue. 

Step 5

  • Leave everything blank.
  • Select Continue. 

Step 6

  • Select Finish. 


If you need a login or password, try these defaults:

  • OpenMRS: admin/test
  • Tomcat: root/openmrs
  • MySQL: root/openmrs
  • Appliance: openmrs/openmrs

If you want root access you can type the command: sudo su and then type the password openmrs when prompted.

The appliance is built from an

Ubuntu Server

(10.04). You can treat it like any Ubuntu install.

The appliance assumes defaults to an internal NAT mode. If you do not get the "Welcome to OpenMRS" message when it starts, your appliance is probably not getting an IP from your VM manager.

The appliance is not meant for production environments. It uses very weak passwords with no encryption and does not support very large datasets. Please do not put patient data into the appliance without considering these limitations.

If you have any questions, email the Community mailing list for assistance. If you want to help with the next version of OpenMRS appliance, see the repository.

  • No labels

1 Comment

  1. Thank you for the nicely presented steps to install openMRS. Correction that may help improve: In Step 6/7, the screenshots and the descriptions must be for another version. In the version I just installed ( Version: 1.9.7 Build 60bd9b), things are different. Similarly, the password for "admin" is not "test" but rather "Admin123".