Release NotesContents::
Target audience: Mifos specialists.

These release notes contain important information about Mifos version 1.2 (code name: Rhino) and higher. Mifos version 1.2 is primarily a bug fix and maintenance release that builds on version 1.1. 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.2.x release package.


Mifos now provides an applicationConfiguration.custom.properties file in the conf folder of the release package that you can use to customize your Mifos installation. Otherwise, Mifos configuration remains relatively unchanged since version 1 1 See Configuring Mifos for details on how to set up Mifos, especially before you first deploy.


Mifos version 1.2 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

GLIM Functional Specification

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.
  • Bulk Loan Creation - Loans created in this feature do not include fees that are part of the loan products. Issue 2337. Fixed in 1.2.2.

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.
  • Reporting permission error: After restarting Mifos, you may receive a reporting permission error when you try to view a report that previously worked. This error only occurs for certain data sets. The workaround is to reload the reports after restarting Mifos. Issue 2255. Fixed in Release 1.2.1.

`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.2.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!