Mifos X Platform 23.12.31 - Installation Instructions on Linux Ubuntu 22.04 LTS

1. Objective

Provide clear instructions in order to Install the Mifos Platform 22.12.31 Release on a Linux Ubuntu 22.04 LTS Operating System, these instructions should ideally be executed by users with basic technical skills.

2. Target Audience

3. System requirements

4. Deployment Architecture

This is a graphical representation of the components that will be installed, they are highlighted in yellow, and the others put in the graphic as a reference and they can be used for extending the functionality.

Open

5. Instructions

*The following commands must be verified in a text plain editor before being executed.

1. Install Java Zulu JDK 17

sudo apt install gnupg ca-certificates curl

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

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

sudo apt update

sudo apt install zulu17-jdk

java -version

2. Get the Apache Tomcat version 10.1 which is the Application Server required to run Mifos X 23.12-RELEASE

wget https://dlcdn.apache.org/tomcat/tomcat-10/v10.1.17/bin/apache-tomcat-10.1.17.zip 

3. Unzip the file in a folder

unzip apache-tomcat-10.1.17.zip

4. Delete the ROOT default content 

rm -Rf ./apache-tomcat-10.1.17/webapps/ROOT/*

5. Download the Mifos X 23.12.31 package

cd $HOME

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

unzip mifosplatform-23.12.31.RELEASE.zip

cd mifosplatform-23.12.31.RELEASE.zip

5. Copy the Mifos WebApp which will be used as the backoffice 

cp -Rf ./webapp/* ./apache-tomcat-10.1.17/webapps/ROOT

6. Copy the Apache Fineract binary

cp fineract-provider.war ./apache-tomcat-10.1.17/webapps/

7. Install MariaDB Database server

sudo apt update

sudo apt install mariadb-server

8. Secure the installation setting a password for the root user

sudo mysql_secure_installation

9. 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

10. Export the environment variables required by Apache Fineract in order to use the root password that was set in the step “h”, also we are disabling the SSL because this is a demonstration. We encourage you to use the secure connection by enabling HTTPS. This variables are executed using the Linux Terminal.

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.

11. Run the command for executing the Apache Tomcat

./catalina.sh run

12. Open the Mifos X 23.12 User Interface on a web browser

http://localhost:8080 

The credentials for login:

user: mifos 

password: password 

13. If you require some help please contact us. These are the channels available to get in contact: https://mifos.org/resources/community/communications/

    Please include screens, logs (use a paste tool like https://privatebin.net/ ), 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.