Mifos X Platform 23.12.31 - Installation Instructions on Windows 11 Home x86_64

Provide clear instructions in order to Install the Mifos Platform 23.12.31 Release on a Windows 11 Home x86_64 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 Software Installation on Windows.

System requirements

Hardware:

8Gb RAM
2 vCPUs (Intel x86 64bits or AMD x86 64bits)
32Gb Storage

Software:

Windows 11 Home x86_64 Operating System
Apache Tomcat 10.1
Java JDK Zulu version 17 LTS
MariaDB 11.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.

Instructions

Install MariaDB server
Go to MariaDB Download Web Page and select the version 11.3 for Windows.	https://mariadb.org/download/

Double click on the file that was downloaded
The Installation Wizard will help us to have a graphical UI for the process. Click on the Next button.
Read the license and check the box “I accept the terms in the License Agreement” and click on the “Next” button.
Select the software that will be installed as it is shown in the Screenshot. And click on the “Next” button.
Set the root password, in this case we are setting it as: skdcnwauicn2ucnaecasdsajdnizucawencascdca Make sure to set the same password in the environment variables in the following section.
Select the 3306 port. Please make sure that it is free uninstalling old MySQL or MariaDB installations, if you do this make sure to backup your data.
Click on the “Install” button.
Depending on your hardware setting, it could take some time to complete.
Once the process is completed click on the “Finish” button.
Using the Windows application launcher, execute the “HeidiSQL” application. It will show an initial screen like this one.
Create a connection to the localhost: IP: 127.0.0.1 Port: 3306 User root Password: skdcnwauicn2ucnaecasdsajdnizucawencascdca And click on the “Open” button
In the left menu, you can browse the default schemas. It is required to create two: fineract_tenants fineract_default
Rick click on the left menu > Create New > Database
Create new database Name: fineract_tenants Collation: utf8mb4_unicode_ci Click on the “Accept” button.
Create new database Name: fineract_tenants Collation: utf8mb4_unicode_ci Click on the “Accept” button.

Set the Apache Fineract’s environment variables
In the Windows Application Launcher look for the System Variables Edition functionality
On the bottom of the window, look for “Env Variables”
In the “Env Variables”, add a new entry: Name: FINERACT_DEFAULT_TENANTDB_PWD Value: skdcnwauicn2ucnaecasdsajdnizucawencascdca Click on the “Accept” button.
In the “Env Variables”, add a new entry: Name: FINERACT_HIKARI_PASSWORD Value: skdcnwauicn2ucnaecasdsajdnizucawencascdca Click on the “Accept” button.
In the “Env Variables”, add a new entry: Name: FINERACT_SERVER_SSL_ENABLED Value: false Click on the “Accept” button.
In the “Env Variables”, add a new entry: Name: FINERACT_SERVER_PORT Value: 8080 Click on the “Accept” button.
Export the environment variables required by Apache Fineract in order to use the root password that was set in the MariaDB Installation, also we are disabling the SSL because this is a demonstration. We encourage you to use the secure connection by enabling HTTPS.

Install Java Zulu JDK 17
Go to Java Zulu JDK Download Web Page	https://www.azul.com/downloads/#downloads-table-zulu
Select the Java 17 LTS Windows version, there are two options, we are going to download the Windows Installer (msi file extension)
Double click on the file that was downloaded
The Installation Wizard will help us to have a graphical UI for the process. Click on the Next button.
Select the options as it is shown in the Window (including the JAVA_HOME option) and click on the Next button.
Click on the Next button in order to start the Installation process.
Once completed the process you can click the Finish button. It could take a few seconds or some minutes, depending on your PC hardware settings.
in order to verify that the JDK Zulu has been installed, open a cmd terminal.
On the terminal execute the following command: java -version It should have a similar output as the screenshot.

Get the Apache Tomcat version 10.1 which is the Application Server required to run Mifos X
Go to Apache Tomcat Download Web Page	https://tomcat.apache.org/download-10.cgi
Select the binary for Windows Service Installer
Double click on the file that was downloaded
The Installation Wizard will help us to have a graphical UI for the process. Click on the Next button.
Read the license and click on the “I agree” button.
Check the options as per the Screenshot and click on the “Next” button.
Check the options as per the Screenshot and click on the “Next” button. For the example we have created a simple Tomcat Administrator and its password, this is optional.
Verify the path of the Zulu Java 17 Installation and click on the “Next” button.
Verify the location of the Apache Tomcat Installation and click on the “Next” button. This location is important because we will use it later for copying the Mifos WebApp files and the Apache Fineract war file.
Complete the Installation, checking the “Run Apache Tomcat” option and click the “Finish” button.
Apache Tomcat Service will start. It could take a few seconds or some minutes, depending on your PC hardware settings.
Once completed you can check that Tomcat is running opening a Web browser and go to http://localhost:8080 A web page will be displayed

Delete the Apache Tomcat ROOT folder content and copy on it the content of the Webapp Mifos Release 23.12
Execute the File Explorer with Aministrator’s privileges then navigate to the Apache Tomcat Location that was defined in the previous step.
You will get a warning message about the access grants to the Apache Tomcat Folder. Click on the “Continue” button.
Select all the files and folders inside the Apache Tomcat “ROOT” folder and delete them.
Go to the mifosplatform-23.12.31.RELEASE folder that was unzipped and select the content of the “webapp” folder. Copy the files and folders on it.
Go back to the Apache Tomcat “ROOT” folder and paste the files that were selected in the previous step.

Copy the Apache Fineract binary
Go to the mifosplatform-23.12.31.RELEASE folder that was unzipped and select the fineract-provider.war file and copy it.
Paste fineract-provider.war in the Apache Tomcat “webapps” folder. It will be deployed and at the end it will create a “fineract-provider” folder. Please wait some minutes, the Apache Fineract deployment process and its first time running will take some minutes to complete.

Verify the Mifos Platform 23.12.31 Release

Open the Mifos X 23.12 User Interface on a web browser

http://localhost:8080

The credentials for login:

user: mifos

password: password

Once you can enter into the Mifos WebApp the initial page will look like this one.

Enjoy and give us feedback.

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

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