Wiki Spaces


Get Help from Others

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


Page tree
Skip to end of metadata
Go to start of metadata

Steps to follow when setting up openmrs Platform for the first time.

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 (The password should be at least 8 characters with both upper and lower cases and 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/Admin123
  • 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. user-a60a2

    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".