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

Owned by Victor Romero
Last updated: Feb 21, 2024
8 min read

 

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.

 

 

  1. Target Audience

 

Username

User description

General Public

User should have basic knowledge about Software Installation on Windows.

 

 

 

 

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

 

 

 

 

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

 

 

 

  1. Instructions

 

 

  1. Install MariaDB server

Go to MariaDB Download Web Page and select the version 11.3 for  Windows.

Download MariaDB Server

 

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.

 

 

 

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

 

 

  1. Install Java Zulu JDK 17

Go to Java Zulu JDK Download Web Page

Azul Downloads  

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.

 

 

 

  1. Get the Apache Tomcat version 10.1 which is the Application Server required to run Mifos X 

Go to Apache Tomcat Download Web Page

Apache Tomcat® - Apache Tomcat 10 Software Downloads  

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

 

 

 

 

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

 

 

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

 

 

 

  1. 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: Communications

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