Installation of openMRS 2.8.0.0 on Ubuntu 24.04

Development
1

Hello Community and Support,

I am currently installing openMRS on Ubuntu 24.04 and facing some challenges. After successfully installing Java JDK, Tomcat and deploying the openmrs.war file into tomcat webapps folder and accessin https://domainname/openmrs, the following message is displayed

”**If you are seeing this page, it means that the OpenMRS Platform is running successfully, but no user interface module is installed. Learn from the available resources below.”

I am using OpenMRS 2.8.0.0** OpenMRS Platform 2.8.0.0 Running!

I Installed the Legacy UI module as asked by the openMRS documentation, and copied the .omod file (legacyui-{versionNumber}.omod) into the .openMRS/modules directory but that did not change anything.

Could someone help?**

Thank you**

2

Did you restart Tomcat after deploying the legacy UI?

3

Yes. Many times

4

Then most likely it’s because Tomcat can’t “see” the .OpenMRS/modules folder. Was that an existing folder you moved things into or a folder you created?

Generally, the folder is resolved relative to the $HOME directory of the user Tomcat is running as.

5

my folder structure is the following: /opt/tomcat .OpenMRS webapps openmrs

my $HOME is /root

6

These are the steps I followed on a Ubuntu 24.04 and still failing with the same message ” If you are seeing this page, it means that the OpenMRS Platform is running successfully, but no user interface module is installed. Learn from the available resources below.”

STEP1: I ran “mvn clean install -DskipTests=true”

\[INFO\]
\[INFO\] Legacy UI Module … SUCCESS \[  5.125 s\]
\[INFO\] Legacy UI Module API … SUCCESS \[ 10.911 s\]
\[INFO\] Legacy UI Module OMOD … SUCCESS \[ 19.419 s\]
\[INFO\] ------------------------------------------------------------------------
\[INFO\] BUILD SUCCESS
\[INFO\] ------------------------------------------------------------------------
\[INFO\] Total time:  36.175 s
\[INFO\] Finished at: 2026-02-27T20:07:59+01:00
\[INFO\] ------------------------------------------------------------------------

STEP2 : CHECK legacyui-3.0.0-SNAPSHOT.omod is generated

root@vmi2649250:/tmp/openmrs-module-legacyui#

oot@vmi2649250:/tmp/openmrs-module-legacyui# cd omod
root@vmi2649250:/tmp/openmrs-module-legacyui/omod# ll
total 24
drwxr-xr-x  4 root root 4096 Feb 27 20:07 ./
drwxr-xr-x  7 root root 4096 Feb 26 20:44 ../
-rwxr-xr-x  1 root root 7728 Feb 26 20:43 pom.xml\*
drwxr-xr-x  4 root root 4096 Feb 26 20:43 src/
drwxr-xr-x 10 root root 4096 Feb 27 20:07 target/
root@vmi2649250:/tmp/openmrs-module-legacyui/omod# cd target
root@vmi2649250:/tmp/openmrs-module-legacyui/omod/target# ll
total 6600
drwxr-xr-x 10 root root    4096 Feb 27 20:07 ./
drwxr-xr-x  4 root root    4096 Feb 27 20:07 ../
drwxr-xr-x  6 root root    4096 Feb 27 20:07 classes/
drwxr-xr-x  2 root root    4096 Feb 27 20:07 dependency-maven-plugin-markers/
drwxr-xr-x  3 root root    4096 Feb 27 20:07 generated-sources/
drwxr-xr-x  3 root root    4096 Feb 27 20:07 generated-test-sources/
drwxr-xr-x  7 root root    4096 Feb 27 20:07 legacyui-3.0.0-SNAPSHOT/
-rw-r–r--  1 root root  207450 Feb 27 20:07 legacyui-3.0.0-SNAPSHOT-tests.jar
-rw-r–r--  1 root root 1956600 Feb 27 20:07 legacyui-3.0.0-SNAPSHOT.jar
-rw-r–r--  1 root root 4546939 Feb 27 20:07 >egacyui-3.0.0-SNAPSHOT.omod
drwxr-xr-x  2 root root    4096 Feb 27 20:07 maven-archiver/
drwxr-xr-x  3 root root    4096 Feb 27 20:07 maven-status/
drwxr-xr-x  3 root root    4096 Feb 27 20:07 test-classes/

STEP3: copy legacyui-3.0.0-SNAPSHOT.omod to .OpenMRS/omod/target

Install the module After successfully building the legacyui module, you will find it at openmrs-module-legacyui/omod/target/legacyui-{version}-SNAPSHOT.omod. Take this file and install it, as described in the User Interface Modules#legacyui section.

root@vmi2649250:/tmp/openmrs-module-legacyui/omod/target# cp *.omod /root/.OpenMRS/modules root@vmi2649250:/tmp/openmrs-module-legacyui/omod/target# cp *.omod /opt/tomcat/.OpenMRS/modules

STEP4: Restarted daemon-reload and tomcat service Restart OpenMRS

7

It was an issue with the .OpenMRS/openmrs-runtime.properties. A wrong password was set by default by the installation. When you install openmrs it asks you the root password to connect to the mySQL database.

However the openmrs-runtime-.properties password I’ve found there was incorrect.

1 Like