EDDYMENS

MIS

How To Install Apache Fineract With Docker

Table of contents

Introduction

In this guide, we will walk through the steps to isntall Apache Fineract [↗] using Docker. This setup includes the Community App (UI) [↗], which provides a web interface to interact with the Fineract APIs.

Checkout my What is Fineract guide [→] if you are new to Fineract.

Prerequisite: Ensure you have Docker [↗] and Docker Compose installed before proceeding.

Clone the repository

Start by cloning the official Fineract repository and navigating into the project directory:

01: git clone https://github.com/apache/fineract.git
02: cd fineract

Launch the Containers

Start the services in detached mode:

$ docker-compose up -d

Give it a few minutes, especially the first time.

Setting up the Mifos (Web App)

The Mifos web app is frontend that implements the Fineract backend. This makes it easy to check out what Fineract has to offer from the comfort of a user interface.

To set it up start by cloning the web-app repository:

01: git clone https://github.com/openMF/web-app
02: cd web-app

The launch the container using the following command: 

$ docker-compose up -d

Access the services

Once everything is up:

Fineract API

$ https://localhost:8443/fineract-provider/api/v1/

Community App (UI)

$ http://localhost:4200/

Login credentials

Use the following default credentials to log in:

  • Username: mifos
  • Password: password

A few notes

HTTPS warning

Your browser might warn you about SSL,just proceed anyway (local dev).

Database takes time

MariaDB needs time to initialize. If Fineract fails:

$ docker-compose restart fineract

Then try to log onto the web portal again http://localhost:4200/

Ports Mapping

  • 8443: Fineract API

  • 4200: Web App

  • 5000: Debugging

Make sure nothing else is using them.

Logs & Debugging

Run docker-compose logs to debug.


[Back to table of content]