Objective
Provide clear instructions in order to Install the Mifos Platform 24.04.30 Release on a Linux Ubuntu 24.04 LTS Operating System, these instructions should ideally be executed by users with basic technical skills.
Target Audience
Username | User description |
General Public | User should have basic knowledge about Linux commands. |
System requirements
Hardware:
|
Software:
|
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.
Instructions
*The following commands must be verified in a text plain editor before being executed.
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
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.23/bin/apache-tomcat-10.1.23.zip
Unzip the file in a folder
unzip apache-tomcat-10.1.19.zip
Delete the ROOT default content
rm -Rf ./apache-tomcat-10.1.19/webapps/ROOT/*
Download the Mifos X 24.04.30 package
cd $HOME
wget https://sourceforge.net/projects/mifos/files/Mifos%20X/mifosplatform-24.04.30.RELEASE.zip
unzip mifosplatform-24.04.30.RELEASE.zip
cd mifosplatform-24.04.30.RELEASE
Copy the Mifos WebApp which will be used as the backoffice
cp -Rf ./web-app/* ../apache-tomcat-10.1.23/webapps/ROOT
Copy the Apache Fineract binary
cp fineract-provider.war ../apache-tomcat-10.1.23/webapps/
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 step “h”, 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 24.04 User Interface on a web browser
The credentials for login:
user: mifos
password: password