Mifos X Platform 25.03.22 - Installation Instructions on Linux Ubuntu 24.04 LTS

Username

User description

General Public

Users should have basic knowledge about Linux commands.

Hardware:

• 8Gb RAM 

• 2 vCPUs (Intel x86 64bits or AMD x86 64bits)

• 32Gb Storage 

Software:

• Linux Ubuntu 24.04 LTS 64 bits Operating System

• Apache Tomcat 1.10.1

• Java JDK Zulu version 17 LTS

• MariaDB 11.4

1. Install Java Zulu JDK 17

Installation of the necessary tools:

$ sudo apt install gnupg ca-certificates curl

Download and convert the GPG key:

$ curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg

Add a new APT repository to install Azul Zulu packages:

$ echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list

Update the package list:

$ sudo apt update

Install the Zulu JDK 17:

$ sudo apt install zulu17-jdk

Comprobar la versión de java:

$ java -version

2. Get the Apache Tomcat and Mifos X 25.03.22-RELEASE

Install apache Tomcat version 10.1.23 which is the Application Server required to run Mifos X 25.03.22-RELEASE:

$ wget https://dlcdn.apache.org/tomcat/tomcat-10/v10.1.34/bin/apache-tomcat-10.1.34.zip 

Unzip the file in a folder:

$ unzip apache-tomcat-10.1.34.zip

Delete the ROOT default content:

$ rm -Rf ./apache-tomcat-10.1.34/webapps/ROOT/*

Download the Mifos X 24.12.24 package:

$ cd $HOME

$ wget https://sourceforge.net/projects/mifos/files/Mifos%20X/mifosplatform-25.03.22.RELEASE.zip 

$ unzip mifosplatform-25.03.22.RELEASE.zip

$ cd mifosplatform-25.03.22.RELEASE

Open



Copy the Mifos WebApp which will be used as the backoffice 

$ cp -Rf ./webapp/* ../apache-tomcat-10.1.34/webapps/ROOT

Copy the Apache Fineract binary

$ cp fineract-provider.war ../apache-tomcat-10.1.34/webapps/

3. Install MariaDB Database server

$ sudo apt update

$ sudo apt install mariadb-server

Secure the installation setting a password for the root user:

$ sudo mysql_secure_installation

Connect to MariaDB in order to create the two databases required by Apache Fineract:

$ mysql -u root -p 

$ CREATE database `fineract_tenants` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

$ CREATE database `fineract_default` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

$ exit

Export the environment variables required by Apache Fineract in order to use the root password that was set in the previous step, also we are disabling the SSL because this is a demonstration. We encourage you to use the secure connection by enabling HTTPS.

$ export FINERACT_DEFAULT_TENANTDB_PWD=skdcnwauicn2ucnaecasdsajdnizucawencascdca

$ export FINERACT_HIKARI_PASSWORD=skdcnwauicn2ucnaecasdsajdnizucawencascdca

$ export FINERACT_SERVER_SSL_ENABLED=false

$ export FINERACT_SERVER_PORT=8080

Note: The username and password are shown as an example, you must enter your own username and password.

Run the command for executing the Apache Tomcat

$ ./catalina.sh run

Open the Mifos X 25.03 User Interface on a web browser

http://localhost:8080

The credentials for login:

user: mifos 

password: password

If you require some help please contact us. These are the channels available to get in contact: Communications

Please include screens, logs (use a paste tool like Encrypted note on PrivateBin ), description of the issue with all the details that you can share. Please be careful and avoid to include sensitive data.

Remember that these installation instructions are for a quick way to get the Mifos X Platform up and running very quickly. You have to protect the sensitive data in motion/rest, secrets, connections, credentials, etc. based on your local requirements.