Overview
The new OpenMRS Platform (as from 2.0) does not have a user interface. After successfully installing the platform, you will need to install one of the available user interface modules. This wiki will document how to install the legacyUI and the Reference Application on top of the platform.
Note: A successful installation of Platform 2.0 means you reached up to the point where you see a page telling to install a user interface module.
Installing LegacyUI module
- Getting the legacyui
git clone https://github.com/openmrs/openmrs-module-legacyui.git
2. Building the code
cd openmrs-module-legacyui
mvn clean install
3. Installing into openmrs
After successfully building the legacyui, we now need to install it into our openmrs instance. To do this
- Look for a .omod file inside openmrs-module-legacyui/omod/target. It should be something like legacyui-1.0-SNAPSHOT.omod.
- Copy the file and paste to ${HOME}/.OpenMRS/modules. Note: if you are on windows, ${HOME} is usually the my documents folder.
4. Verifying the installation
First you need to restart openmrs. To restart here means cancel the already running instance of jetty (using CTRL + C) and then run
mvn jetty:run
Now try accessing openmrs from the browser(localhost:8080/openmrs). You should be redirected to the login page. (default username/password is admin/Admin123)