Mifos X Platform 25.03.22 - Installation Instructions on Windows 11 Home x86_64 - Docker, Postgresql and 2FA

Username

User description

General Public

Users should have basic knowledge about Software Installation on Windows.

Hardware:

• 8Gb RAM 

• 2 vCPUs (Intel x86 64bits or AMD x86 64bits)

• 32Gb Storage 

Software:

• Windows 11 Home x86_64 Operating System

• Docker 25.03

• Powershell

• Apache Fineract 1.11

1. Install Docker desktop

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

Install Docker Desktop on Windows

Wait for the download file.

Double click on the file that was downloaded

The Installation Wizard will help us to have a graphical UI for the Docker Installation process. Click on the “Ok” button.

The wizard will unpack the files

Once the process is completed click on the “Close and restart” button and the computer will restart.

Once the computer has restarted, the docker subscription screen will open, click the "Accept" button

Select the recommended settings and click the "Finish" button

click "Continue without signing in"

Click the “Skip survey” button.

The Docker Engine will start

In the launch bar, look for the “ Docker Desktop” and start it.

2. Download zip file from SourceForge https://sourceforge.net/projects/mifos/files/Mifos%20X/mifosplatform-25.03.22.RELEASE.zip/download 

When you enter the download link, the file will automatically start downloading

We locate the downloaded zip file

We unzip the zip file

We enter the path where the decompressed file is saved

We locate the unzipped file

3. We start the configuration to start the containers in docker.

Login to powershell as administrator

On the powershell screen we go to the path where we have the unzipped docker compose file and to the postgresql folder

once in the path and in the folder, we raise the docker compose containers with the command, docker compose up -d

Validate that the three containers are shown on the docker desktop

Web-App

Fineract

Postgresql

We review the Logs to validate that the containers were started correctly. Please be patient, it could take some minutes to complete.

Validate that Mifos X Release 25.03 is up and running entering the following url  http://localhost in a Web Browser

Sign in with the default credentials:

User: mifos

Password: password

We stop the container from the docker desktop interface, click on the "stop" button

The container is stopped

1. Set up Apache Fineract's email service

Once inside the system: 

• Click the "Admin" button located at the top of the screen.

• Select the ‘System’ option.

Click the "External Services" option.

Select the "Email External Service" option.

Setup the  Apache Fineract's Email service for sending emails.

2. Ensure that users can receive emails

• Click the "Admin" button located at the top of the screen.

• Select the ‘Users’ option.

Select the user to configure (the admin user for this manual).

Edit the user to add a valid email address.

3. Set the environment variable in the docker-compose.yml file

Enter the postgresql folder.

Use a text editor like VScode or Notepad to edit the docker-compose.yml file.

At the end of the file, add the line:

• FINERACT_SECURITY_2FA_ENABLED=true

Save the changes.

Once in the path, we raise the docker compose containers with the command:

$ docker compose pull | docker compose down | docker compose up -d | docker compose logs -f

Validate that containers are lifted correctly:

4. Validate the use of Two-Factor Authentication (2FA) for login

Validate that Mifos X Release 25.03 uses 2FA. Enter the URL http://localhost in a web browser.

Sign in with the default credentials:

User: mifos

Password: password

Select the delivery method "Send email to {user}".

Click the "Request OTP" button.

The system will send the access token to the email provided in the previous steps.

In the OTP field, enter the token received by email.

Press the "Validate OTP" button.

The system should display a successful login.

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.

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.