Mifos X Platform 23.12.31 - Installation Instructions on Linux Ubuntu 22.04 LTS
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.
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://archive.apache.org/dist/tomcat/tomcat-10/v10.1.17/bin/apache-tomcat-10.1.17.zip
Unzip the file in a folder
unzip apache-tomcat-10.1.17.zip
Delete the ROOT default content
rm -Rf ./apache-tomcat-10.1.17/webapps/ROOT/*
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
Copy the Mifos WebApp which will be used as the backoffice
cp -Rf ./webapp/* ./apache-tomcat-10.1.17/webapps/ROOT
Copy the Apache Fineract binary
cp fineract-provider.war ./apache-tomcat-10.1.17/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_general_ci;
CREATE database `fineract_default` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
exit
Export the environment variables required by Apache Fineract in order to use the root password that was set in the step “8”, these are the DB user and password tha you have set in the step “8”, they are examples, make sure you are using a secure password for your DB, also we are disabling the SSL because this is a demonstration environment, this is not a production ready setup. 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.
Run the command for executing the Apache Tomcat
sudo /etc/init.d/tomcat start && sudo tail -f /usr/share/tomcat10/logs/catalina.out
Open the Mifos X 23.12 User Interface on a web browser
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: 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.
@Victor Romero thank you for correcting this part