Mifos X Installation Hub

Install Mifos X and Apache Fineract step by step

Practical, version-aware installation guides for developers, implementation consultants and financial institutions. Learn how to install, configure, secure and operate Mifos X in local, testing and production environments.

Choose your version Start with Docker

Select your path

Which installation should you follow?

Choose the deployment path that matches your objective. A local demonstration environment and a production financial system should not use the same architecture.

Beginners and developers

Local learning environment

Use Docker Compose to run the backend, database, and frontend quickly.

View recommended guide

NBFCs, MFIs, SACCOs and banks

Production financial institution

Use Ubuntu, a managed database, Nginx, SSL, monitoring, backups, and separate environments.

View recommended guide

Java and Angular developers

Custom development environment

Run Apache Fineract and the Mifos Web App from source with separate development configuration.

View recommended guide

Complete learning sequence

Mifos X installation guides

Choose the Correct Mifos Version

Start here

Understand Mifos X, Apache Fineract, Mifos Web App, Community App, supported Java versions, and version compatibility.

Read step-by-step guide

System Requirements

Prerequisites

Review recommended CPU, RAM, storage, operating system, Java, database, domain, and SSL requirements.

Read step-by-step guide

Docker Quick Installation

Beginner

Run Apache Fineract and the Mifos Web App locally using Docker and Docker Compose.

Read step-by-step guide

Ubuntu Production Installation

Production

Deploy Apache Fineract and the Mifos Web App on an Ubuntu production server.

Read step-by-step guide

Apache Fineract Backend Setup

Backend

Configure Java, the database, environment variables, tenants, Liquibase migrations, and backend services.

Read step-by-step guide

Mifos Web App Installation

Frontend

Install, configure, build, and connect the Mifos Web App to Apache Fineract.

Read step-by-step guide

Database Configuration

Database

Configure database users, permissions, tenant databases, backups, restore procedures, and performance settings.

Read step-by-step guide

Domain, Nginx and SSL

Security

Connect a domain, configure reverse proxy rules, enable HTTPS, and secure the production deployment.

Read step-by-step guide

Post-Installation Configuration

Configuration

Complete the first login, organisation setup, offices, staff, roles, products, accounting, and scheduled jobs.

Read step-by-step guide

Installation Troubleshooting

Support

Resolve common Docker, Java, database, Liquibase, CORS, API, Angular, SSL, and authentication errors.

Read step-by-step guide

Installation checklist

Production readiness

Select and record compatible component versions
Prepare the server and database
Install and verify Apache Fineract
Install and connect the Mifos Web App
Configure tenant and organisation settings
Enable domain, HTTPS and security controls
Configure backups, monitoring and logs
Complete functional and performance testing

Video guide

Follow the installation visually

The complete video series will demonstrate installation commands, configuration files, expected outputs, common errors and production verification.

Video series coming soon

Written guides will remain available alongside every video, including commands, transcripts and downloadable resources.

Browse all tutorials

Professional Mifos services

Need help deploying Mifos X in production?

MifosX provides Apache Fineract and Mifos implementation, customization, migration, API integration, cloud deployment, training and production support for financial institutions worldwide.

✓ Implementation✓ Custom development✓ Migration✓ Cloud deployment✓ Training and support

Talk to a Mifos expert Talk to a MifosX expert

← Documentation home Next: Choose the correct version →