Apache Fineract: A Platform for Microfinance
The next evolution of Apache Fineract focuses on being faster, lighter and cheaper to change (than the existing Mifos) so that it is more responsive to the needs of Microfinance Institutions and Integrators.
Requirements
- Java >= 1.8 (Oracle JVMS have been tested)
- gradle-wrapper.jar version 2.10
- MySQL 5.5
Instructions to download gradle wrapper
By running following command, it will download the gradle wrapper from Fineract git repository and puts under fineract-provider/gradle/wrapper
wget --no-check-certificate -P fineract-provider/gradle/wrapper https://github.com/apache/incubator-fineract/raw/develop/fineract-provider/gradle/wrapper/gradle-wrapper.jar (or) curl --insecure -L https://github.com/apache/incubator-fineract/raw/develop/fineract-provider/gradle/wrapper/gradle-wrapper.jar > fineract-provider/gradle/wrapper/gradle-wrapper.jar
Instructions to run Apache RAT (Release Audit Tool)
- Extract the archive file to your local directory.
- Download gradle-wrapper.jar version 2.10 and place it in the fineract-provider/gradle/wrapper folder. See 'Instructions to download gradle wrapper' above.
- Run
./gradlew rat
. Report will be generated under build/reports/rat/rat-report.txt
Instructions to build war file
- Extract the archive file to your local directory.
- Download gradle-wrapper.jar version 2.10 and place it in the fineract-provider/gradle/wrapper folder. See 'Instructions to download gradle wrapper' above.
- Run
./gradlew clean war
or./gradlew build
to build deployable war file which will be created at build/libs directory.
Instructions to execute Integration tests
- Login to mysql DB using
mysql -u root -pmysql
- Create the mifosplatform-tenants database using
CREATE DATABASE mifosplatform-tenants
. - Create the default tenant database using
CREATE DATABASE mifostenant-default
. - Download gradle-wrapper.jar version 2.10 and place it in the fineract-provider/gradle/wrapper folder. See 'Instructions to download gradle wrapper' above.
- Run the following commands:
./gradlew migrateTenantListDB -PdbName=mifosplatform-tenants
./gradlew migrateTenantDB -PdbName=mifostenant-default
- Run
./gradlew clean integrationTest
Version
The latest stable release can be viewed on the develop branch: Latest Release on Develop, View change log
License
This project is licensed under Apache License Version 2.0. See https://github.com/apache/incubator-fineract/blob/develop/LICENSE.md.
Apache Fineract Platform API
The API for the Fineract-platform (project named 'Apache Fineract') is documented in the API-docs under Full API Matrix and can be viewed here.
Online Demos
Developers
Please see https://cwiki.apache.org/confluence/display/FINERACT/Contributor%27s+Zone for the developers wiki page.
Please see https://cwiki.apache.org/confluence/display/FINERACT/How-to+articles for technical details to get started.
Roadmap
Project Release Roadmap on JIRA (Detailed View)
Video Demonstration
Apache Fineract / Mifos X Demo (November 2016) - https://www.youtube.com/watch?v=h61g9TptMBo
More Information
More details of the project can be found at https://cwiki.apache.org/confluence/display/FINERACT.