Mifos X Platform 24.04.30 - Installation Instructions on Linux Ubuntu 24.04 LTS
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 - MXD-121Getting issue details... STATUS 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
Enjoy and give us feedback.
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.