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


  1. Windows: Ensure that Tomcat is started by checking to see if icon in the tray is green or by using this command on cmd:  wmic.exe process list brief | find /i "tomcat"

  2. Download the latest stable release of OpenMRS.
  3. Navigate to http://localhost:8080/manager/html and enter your Tomcat administrator credentials (username and password chosen when installing Tomcat).
  4. In the Tomcat Web Application Manager, enter the location of the downloaded openmrs.war file. Once done, click on the "upload" button and OpenMRS should start deploying.
    1. The deployment may take some time while the file is being copied to the folder C:\Program Files\Apache Software Foundation\Tomcat <version>\webapps and decompressed.
    2. Note that the OpenMRS.war file is most easily downloaded with Mozilla Firefox. Internet Explorer tries to open the file as a Zip file.
  5. At the end of this process, the web page will refresh and /openmrs should be displayed under Applications. Apache Tomcat should also start the application (Running = True; and in Commands, Stop is underlined)

    Another way to do this is unzipping the .war file directly under webapps folder in Tomcat and then restarting it. You will be able to access http://localhost:8080/openmrs and the installation wizard will show.



  • No labels


  1. With the default settings of Tomcat 7, you will get an error while uploading the war file; FileUploadBase$SizeLimitExceededException.  For the work-around visit Troubleshooting Tomcat - Tomcat error when uploading war file - FileUploadBase$SizeLimitExceededException

  2. user-d8141

    In ubuntu from a ssh conection download and deploy:


    sudo apt-get install unzip

    sudo unzip openmrs.war -d /var/lib/tomcat6/webapps/openmrs

    sudo service tomcat6 restart

    cd /var/lib/tomcat6/webapps/openmrs

    sudo chown -R tomcat6

    finally go to http://localhost:8080/openmrs

  3. user-162d8

    Hi Julian,

    I am getting an error "Unrecognized service" for command "sudo service tomcat6 restart". I restarted the service by going into /opt/tomcat6/bin directory and then continued with the above commands but it was unable to locate /openmrs directory. Please help me in deploying it.



  4. user-7ceca


    There is no such directory called /var/lib/tomcat6/webapps/openmrs.. What shall i do for it? Thanks.