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

 

  1. Objective

 

Provide clear instructions in order to Install the Docker Compose 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

  • Docker 25.03

  • Powershell

 

 

 

 

  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 Docker desktop

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

https://docs.docker.com/desktop/install/windows-install/

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.

 

 

 

  1. Download zip file from SourceForge https://sourceforge.net/projects/mifos/files/Mifos%20X/mifosplatform-23.12.31.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

 

 

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

Login to powershell as administrator

Once on the powershell screen we go to the path where we have the unzipped docker compose file and to the mariadb folder

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

The system sends us a message that if we allow public and private networks to access the application. Click the "Permit" button

Validate that the three containers are shown on the docker desktop

 

Web-App

Fineract

MariaDB

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 23.12 is up and running entering the following url  http://localhost in a Web Browser

Sign in with the default credentials:

 

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.