Release NotesContents::
Target audience: Mifos specialists.

These release notes contain important information about Mifos version 1.3 (code name: Gazelle A) and higher. Mifos version 1.3 is a release with improvements to configuration and architecture, testing framework, and developer environment, that builds on version 1.2. In addition to an overview of the major changes since the previous major release known issues and other information are addressed here. Please read this document before you begin using Mifos.



See MifosSystemRecommendations for hardware requirements.


Software requirements are described in the INSTALL file that downloads with the Mifos version 1.3.x release package.


In Mifos 1.3, the location and names of several configuration files have changed. See Configuring Mifos for details on how to set up Mifos, especially before you first deploy.


Mifos version 1.3 supports Internet Explorer version 6.0. There are a few known Firefox bugs and we do not recommend using Firefox with this release.

New Features and Enhancements

  • Collection Sheet Entry Improvements _ Rebuild part of Collection Sheet Entry (Attendance) _ Extra logging of Collection Sheet Entry in mifos_log * Removed threading
  • Batch Job improvements _ Easier batch job configuration _ Improved logging * Added failed state
  • Accelerated Development _ Migration to Maven from Ant _ New Acceptance Test Framework
  • Added more diagnostic information on System Info page

Known Issues

Deployment Isolation

There have been unconfirmed reports that deploying multiple instances of Mifos inside the same Tomcat installation may cause problems. We advise isolating deployments by only deploying a single instance of Mifos inside a single installation of Tomcat until further notice.

Configuration Settings

  • Configuration of Process flow properties: Mifos doesn't start when a process flow property (such as ClientPendingApprovalStateEnabled) has been set to a non-default value. The workaround is to manually update these settings in the database. See the `Process section in Configuring Mifos Mifos <http://mifos.org/developers/wiki/Configuring Mifos#process>`_ for how to work around this problem. Issue 2252.
  • Loan repayment causes null pointer exception if currency is non-standard: If the value for AccountingRules.CurrencyCode is set to something other than the euro (EUR), pound (GBP), rupee (INR), or dollar (USD) in the applicationConfiguration.custom.properties file, repaying a loan may result in a null pointer exception. This is because rounding values for that currency are missing from the Mifos database. The workaround is to enter values for ROUNDING_MODE and ROUNDING_AMOUNT in the currency table in the Mifos database. Issue 2168.


  • Loan Product Definition ranges are not enforced when a loan account is created: _ You can still create a loan account with a grace period even if "Grace type" is specified as "None" in the Loan Product Definition. Issue 1662. _ The number of installments for grace period on loan accounts can be greater than what's defined in the Loan Product Definition for number of grace periods. Issue 1663. * When you edit a loan account, the interest rate is not validated against the allowable range, as defined in the Loan Product Definition. Issue 1882.
  • Loan disbursal: You cannot disburse two loans for the same loan product to the same client or group. To work around this problem, create multiple products with the same product settings. Issue 2006.
  • Rounding issues when fees are removed from active loans: You may experience problems related to rounding when you remove fees from active loans. Issue 1934.
  • Invalid disbursement date error: When editing a group loan, you may receive an "invalid disbursement date" error – even though you have a valid disbursement date. The workaround is to change processes to cancel the loan and create a new one for the group. Issue 2123.

Loan Schedule Independent of Meeting Schedule (LSIM)

  • Grace period and LSIM: "Grace on all repayments" doesn't work when LSIM is enabled. Issue 1994.
  • Minimum/Maximum days between disbursal and first repayment: These settings are broken when LSIM is enabled. Use the default values (1 for Minimum and 365 for Maximum) and do not attempt to edit them. Issues 2005 and 1579.
  • Repayment schedule not updating correctly when disbursal date changed: Mifos does not update the repayment schedule correctly when LSIM is enabled and a loan disbursal date is modified (for example, moved one day forward). The workaround is to close the existing loan account and open a new account that has the desired disbursal date. Issue 2154.
  • Loans created with LSIM on cannot be edited after user logs out of Mifos. Issue 2353.

Memory and Performance

  • Additional permanent generation space may be needed: The Mifos web application may require more permanent generation space than the default. See PermGenOutOfMemory for details.
  • Memory leak: There is a slow memory leak in Mifos that may, under very heavy loads, require restarting the application every two days. Issue 2092.
  • Intermittent problems with bulk-entry submissions: The bulk entry feature occasionally encounters problems when posting transactions—either transactions are posted twice or only a portion is posted. While this problem can't be consistently reproduced, it seems to be exacerbated by heavy loads and poor connectivity. Issues 2011 and 2133.


  • Savings Product Definition: "Minimum balance required for interest" is not working. Issue 1542.
  • Holidays are not changeable: Once you add a new holiday to Mifos, it cannot be edited or deleted. Use caution with this feature. Issue 1398.
  • Issues with adding an unapproved client to an unapproved group: Group must be approved first before an unapproved client can be added to the group. Issue 2210.

`Current list of known bugs. <https://mifos.dev.java.net/issues/buglist.cgi?issue_type=DEFECT&issue_type=ENHANCEMENT&issue_type=FEATURE&issue_type=TASK&issue_type=PATCH&component=mifos&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED&email1=&emailtype1=exact&emailassigned_to1=1&email2=&emailtype2=exact&emailreporter2=1&issueidtype=include&issue_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=fulltext&long_desc=&long_desc_type=fulltext&issue_file_loc=&issue_file_loc_type=fulltext&status_whiteboard=&status_whiteboard_type=fulltext&keywords=Patch&keywords_type=notokens&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&order=Reuse+same+sort+as+last+time&Submit+query=Submit+query>`_

Fixed Issues

Use the following links to see which issues were fixed in Mifos version 1.3.0 and above:



The project owners would like to thank those who have been actively involved in the Mifos community. Your code contributions, ideas, documentation assistance and testing have been extremely helpful in moving the project forward.

A big thanks to the entire Mifos community!