You  can set up an OpenMRS server on your computer for testing and debugging modules. With OpenMRS SDK and Docker, you can set up the OpenMRS server very easily with a step of installing MySQL 5.6; a separate installation of MySQL server is not needed. 

...

Before start, make sure:

1. You have installed:
   • Java SE (the current version of OpenMRS server is built on Java SE 8) 
   • Maven 
   • Docker

2. If you are using Windows 10, you need to use PowerShell as Administrator; if you are using Ubuntu, you need to be the root user.
   To enter the root user mode on Ubuntu, type the following on your terminal window:

   Code Block
   sudo -i sudo -s

   
   

   Note
   Note: Without PowerShell or root user mode, the installation will fail.

   3. You Windows users may also need to swap the SDK over to using TCP instead of HTTP connections. You can expose Docker via TCP (instead of just via HTTP) . This is doable in via Docker Desktop through the following setting:

You'll also need to modify the dockerHost in the SDK properties file (found in C:\Users\“youruser”\openmrs\sdk.properties). Change the "dockerHost=http://127.0.0.1:2375/" line to "dockerHost=tcp://127.0.0.1:2375".

Without this you may encounter the following error: "Unsupported protocol scheme found: 'http://127.0.0.1:2375/". More info here.

Install OpenMRS SDK

1. To install OpenMRS SDK on your system, type:

   Code Block
   mvn org.openmrs.maven.plugins:openmrs-sdk-maven-plugin:setup-sdk

   
   

2. To test the installation, type:

   Code Block
   mvn openmrs-sdk:help

   
   When the installation is successful, the screen displays:

   Code Block
   [INFO] Scanning for projects...    [INFO]    [INFO] ------------------< org.apache.maven:standalone-pom >-------------------    [INFO] Building Maven Stub Project (No POM) 1    [INFO] --------------------------------[ pom ]---------------------------------    [INFO]    [INFO] --- openmrs-sdk-maven-plugin:3.13.6:help (default-cli) @ standalone-pom --- OpenMRS SDK 3.13.6

   For more info, see SDK documentation: https://wikiopenmrs.openmrsatlassian.orgnet/wiki/display/docs/OpenMRS+SDK

Set Up OpenMRS Server

With OpenMRS SDK, You can either install OpenMRS platform or OpenMRS distribution on your system. OpenMRS platform has no user interface. If you want to see basic OpenMRS functions, choose distribution. You can also run multiple servers of different types in parallel.

...

1. Open a browser, type in the server url: http://localhost:8080/openmrs/
   
2. Wait till the initialization process is complete then login with:
   Username: Admin
   Password: Admin123
   You have completed setting up OpenMRS SDK and server. To learn more about OpenMRS SDK go to: OpenMRS SDK, or OpenMRS SDK Step by Step Tutorials.