Mifos User Documentation Portal
  • Overview and Background
    • History and Background
    • Mifos Vision, Mission & Values
    • Who Mifos is For
    • How Mifos is Used
    • The Mifos Stack
      • Overview
    • Mifos v/s Fineract
    • Community app v/s Webapps
  • General Contributing Guidelines
    • Upstream Development Approach
      • Contribution Process
      • The Apache Way
    • Contributors Guide
    • Contribution Guidelines: Android Project
    • Contribution Guidelines: Web Project
  • Getting Started
    • Getting started with Git & Github
    • Postman integration with Gitbook for testing
    • Testing framework-Web
    • Testing framework-Android
    • Mifos CI/CD tools and instructions
  • External 3rd Apps
    • Pentaho Reporting Plugin
    • Payment Hub
  • MifosX
    • Overview
    • User Manual
      • How to Use This Manual
      • For All Users
        • General Navigation
          • Sign In Page
          • Welcome Page
          • Dashboard Page
          • List Page
          • Menu Page
          • Form Page
          • Clients-Groups-Centers Navigation
          • Navigation Tool
          • Global Search
          • Loan Product and Accounting with Mifos
        • Reports
          • Standard Reports Shipped in Mifos X
          • Standard Reports Field Descriptions
          • Custom Reports
            • Creating Simple Pentaho Report and Embedding it to Mifos X
          • XBRL Reporting
      • For Administrators (Mifos X Platform)
        • Initial System Set Up
        • Administration
          • Users
          • Organization
            • Manage Offices
            • Currency Configuration
            • Manage Holidays
            • Manage Funds
            • Manage Employees
            • Bulk Loan Reassignment
            • Standing Instructions History
            • Teller / Cashier Management
            • Fund Mapping
            • Working Days
            • Password preferences
            • Payment type
            • Loan Provisioning Criteria
            • SMS Campaigns
            • Message Gateway Configuration
            • Daily Teller Cash Management
            • Entity Data Table Checks
          • System
            • Manage Data Tables
            • Audit Trails
            • Manage Codes
            • Manage Reports
            • Manage Roles and Permissions
            • Manage Scheduler Jobs
            • Configure Maker-Checker Tasks
            • Global Configuration
            • Manage Hooks
              • Steps for creating sms bridge
            • Account Number Preferences
            • Entity To Entity Mapping
              • External Services
          • Products
            • Loan Products
              • Loan Product Fields
                • Accounting Loan Product Fields
                • Configuring and Disbursing of Top-Up Loan
                • Declining Balance Interest Calculation
                • Enabling Floating Rate
                • Enabling Variable Installments
                • Flat interest calculation
                • Loan Product Fields—Additional Fields for Loans with Variable Terms based on Loan Cycle
                • Recalculate Interest
                • Tranche Loan Fields
              • Setting up Minimum Days between Disbursal and First Repayment
              • Product Mix
            • Charges
            • Floating Rate
            • Savings Products
              • Saving Product Fields
                • Accounting Saving Product Fields
            • Fixed Deposit Products
              • Fixed Deposit Product Fields
                • Accounting Fixed and Recurring Deposit Product Fields
              • Interest rate chart with amount range
            • Recurring Deposit
              • Recurring Deposit Product Fields
            • Interest Calculations for Deposit Products
            • Overdraft Product
            • Share products
              • Dividends
            • Manage Tax configuration
          • Templates
          • mifos dropdown
        • Clients, Groups and Centers
          • Manage Clients
            • Client Life Cycle Statuses
            • Client Relationship Management
          • Manage Groups
          • Manage Centers
        • Accounting
          • Chart of Accounts - General Ledger Setup
            • Default COA sql script
          • Accounts linked to Financial Activities
          • Migrate opening balances (Office-wise)
          • Accounting Rules
          • Provisioning Entries
          • Print General Ledger Listing
          • How To Enter GL Opening Balance
        • Configure Notifications
      • For Operational Users (Mifos X Web App)
        • Accounting operations
          • Add Journal Entries
          • Searching Accounting Transactions
          • Frequent Postings
          • Advanced Accounting Rules
          • Closing Entries
          • Accruals
        • Accounts and Transactions
          • Cash Transaction Processing
          • Deposit Accounts
            • Mifos X Saving Accounts
              • How to Activate a Saving Account
              • How to Add a Charge to a Saving Account
              • How to Approve a Saving Account Application
              • How to Calculate Interest for a Saving Account
              • How to Close a Saving Account
              • How to Create a Saving Account Application
                • Saving Account Fields
              • How to create overdraft account (Draft)
              • How to Delete a Saving Account Application
              • How to Make a Deposit to a Saving Account
              • How to Make a Withdrawal from a Saving Account
              • How to Modify a Saving Account Application
              • How to Post Interest to a Saving Account
              • How to Reject a Saving Account Application
              • How to Transfer funds from a Saving Account
              • How to Withdraw a Saving Account Application
            • Standing Instructions
              • How to Set up a Standing Instruction
                • Standing Instruction Form Fields
            • Term Deposit Accounts (Fixed Deposit / Recurring Deposit)
              • How to Activate a Term Deposit Account
              • How to Add a Charge to a Term Deposit Account
              • How to Approve a Term Deposit Account Application
              • How to Calculate Interest for a Term Deposit Account
              • How to Create a Term Deposit Account Application
                • Term Deposit Account Fields
              • How to Delete a Term Deposit Account Application
              • How to Make a Deposit to a Recurring Term Deposit Account
              • How to Modify a Term Deposit Account Application
              • How to Post Interest to a Term Deposit Account
              • How to Reject a Term Deposit Account Application
              • How to Withdraw a Term Deposit Account Application
            • Creating Recurring Deposit Account:
          • Loan Accounts
            • How to Create a Loan Account Application
              • Loan Account Fields
            • How to Make Repayments on a Client Loan Account
            • Track Loan Performance History
            • How to Approve a Loan Account Application
            • How to Add a Charge to a Loan Account
            • How to Modify a Loan Account Application
            • How to Assign a Loan Officer
            • How to Reject a Loan Account Application
            • How to Withdraw a Loan Account Application
            • How to Delete a Loan Account Application
            • How to Add Collateral to a Loan Account
            • How to Add/Remove/Modify a Guarantor to a Loan Account
            • How to Manage Loan Account Disbursement
            • How to Make Repayments on a Group Loan Account
            • Using collection sheet or other payment types for making payments
            • How to Waive Interest for a Loan Account
            • How to Write-off a Loan Account
            • How to Close a Loan Account as Rescheduled
            • How to Close a Loan Account
            • Making Prepay of the loan
            • How to Prepay a Loan Account
            • How To Create Group Loan Account
            • How to Process Bulk JLG Loan Application
            • How to generate - Loan transactions report
            • How to reschedule loan
            • How to provide floating rates
            • How to provide variable installments
            • How to create new loan - Interest Recalculation
            • Tranche loan process
            • Loan with term vary based on loan cycle
            • How to Place Guarantee Funds On-Hold?
          • Overdraft account
          • Saving Accounts
            • How To Create Group Saving Account
          • Share Accounts
        • Checker Inbox & Tasks
      • Side Bar - Features
        • Checker inbox and tasks
        • Collection sheet
        • Help.
        • Individual collection sheet
        • Keyboard short-cuts
        • Navigation
      • Others - mifos dropdown
        • Help
        • Profile
        • Settings
          • Date format
          • Language
        • Signout
      • Data Import Tool
        • Getting started with - Data Import Tool
        • Installing Data Import Tool
      • Glossary of Terms
      • Index
      • Reporting Documentation
      • Mobile Money Tool
    • User Space
      • New Feature Request Content
      • Recommended System Requirement
      • MifosX Overview
      • Installation guide
        • Upgrading Mifosx
        • Install MifosX on Windows
        • Install MifosX on Linux
        • Install MifosX on AWS
      • Release Notes
        • Release 1 and Features List
        • Release 2 and Features List
      • User Manual
        • How to Use This Manual
        • For All Users
          • General Navigation
            • Sign In Page
        • For Administrators
          • Initial System Set Up
        • For Operationals
      • Roadmap
      • Frequently Asked Questions (FAQs)
      • Demo Server Details
    • Developer Space
      • Setting Up Dev Environment
        • Setting up Frontend - community-app
      • Setting up MifosX from latest builds
      • Contributors Guide
      • Customising MifosX
      • Additional features
        • Data import tool
        • SMS campaigns
        • Pentaho reports
      • How Mifosx works
      • Adding a new tenant to MifosX instance
      • Using REST client for testing
      • API documentation
      • Scaling MifosX
      • Upgrading MifosX
      • Troubleshooting guide
  • Core Banking & Embedded Finance
    • Core Banking
      • Overview
    • Embedded Finance
      • Overview
  • Application Framework
    • Payment Hub EE
  • Main Platforms
    • Fineract 1.x
      • Apache Fineract
      • Apache Fineract Client
    • Fineract CN
      • Overview
      • User Manual
  • Staff UI Platforms
    • Fineract 1.x
      • Community-App
      • Web-App
      • Web Self-Service App
        • Online Banking App 2.0 User Manual
          • Developer Environment Setup for Online Banking App 2.0
      • Mobile Field Officer Applications
        • Android Client
          • User Manual
    • Fineract CN
      • Digital Bank User Interface
      • Mobile Field Officer Applications
        • Fineract CN Mobile
  • Customer UI Platforms
    • Fineract 1.x
      • Mobile Banking
        • Mifos Mobile
      • Mobile Wallets
      • Online Banking
    • Fineract CN
      • Mobile Banking
        • Fineract CN Mobile
        • Mifos Mobile CN
      • Mobile Wallets
      • Online Banking
  • Ancillary Tools
    • Fineract 1.x
      • Message Gateway
      • Mifos Passcode
      • PPI Vision
      • DevOps Tooling
      • Fineract Android SDK
      • MifosX Admin
      • Mifos ChatBot
      • Data Import Tool
    • Fineract CN
      • Fineract CN Containers
      • Fineract CN Terraform
  • Payment and Process Orchestration
    • Fineract 1.x
      • Payment Hub
      • Fineract Pentaho
    • Fineract CN
      • Staff Interfaces
        • Digital Bank UI
      • Customer Interfaces
        • Fineract CN Mobile
        • Mifos Mobile CN
        • Fineract CN Mobile
      • Ancillary Tools
        • Fineract CN Terraform
        • Fineract CN Containers
    • Payment Hub EE
Powered by GitBook
On this page
  • 1) Log-in into Mifos X:
  • 2) Set-up your Offices :
  • 3) Configure Currency:
  • 4) Define Holidays:
  • 5) Create Employees:
  • 6) Define Working Days
  • 7) Create Data Tables
  • 8) Define System Codes:
  • 9) Define Roles & Permissions:
  • 10) Create Users :
  • 11) Configure Maker Checker Tasks :
  • 12) Global Configuration:
  • 13) Accounting:
  • 14) Define Charges:
  • 15) Define Products:
  • Others:-
  • Setting up your Fund Source:

Was this helpful?

  1. MifosX
  2. User Manual
  3. For Administrators (Mifos X Platform)

Initial System Set Up

PreviousFor Administrators (Mifos X Platform)NextAdministration

Last updated 2 years ago

Was this helpful?

This section assumes that the Mifos Community App has been successfully downloaded and installed. The Mifos X log in page will appear. This page contains the current version of Mifos X, very helpful links to this User Manual, Functional Specifications, the most frequently asked questions, upcoming news and very helpful links to the community. Take a few minutes and discover the Mifos X community.

Before beginning, take a quick overview of . This will introduce you to Mifos X and will be helpful in system setup.

Once that is accomplished, the next step is to customize Mifos X for your organization’s needs and approach. This can be done using drop-down menus found along the top of the home screen.

After completing and having your at hand, follow these steps for first time log-in:

Tip: Need help downloading and/or installing the Mifos Community App? Please see the or section of this manual for more information.

1) Log-in into Mifos X:

Sign in Page

  • Type username: mifos

  • Type password: password

  • Click "Sign In"

NOTE: The initial username and password will be changed in system set up. The default username and password is Super User to allow for full system set up.

The next step in configuration is to set up your organization. Begin at the main screen, click on Admin then select Organization.

2) Set-up your Offices :

  • In the Office field, enter your main office name.

  • In Parent Office, do not enter a name.

  • In the Opened on field, enter the date your organization opened this office.

  • In the External ID field, enter any numeric identifier your organization may use to further identify your offices. This is an optional field provided for your unique customization. It is not required for effective Mifos functionality.

Review the information entered and if it is all correct, click on the Submit button. The head office is now created.

If your organization has multiple offices, return to the Admin/Organization/Manage Office's screen and select +Create Office. In this example, we use the name "Branch Office". You will enter the name that best describes your additional office name.

NOTE: It is best to set up your head office first. Then set up any regional offices. Finally set up the individual branch offices taking care to link them to the correct regional or Parent office.

3) Configure Currency:

Select Currency Configuration. Click on the +Add/Edit button. Enter your local currency, then press Submit.

4) Define Holidays:

If the holiday affects the entire organization, select Head Office in the drop down menu located on the left top screen. If the holiday being created affects only one office, select that office name, which we have described as "branch office" here. Click on the +Create Holiday button. Next, fill in the dates of the holiday, name of the holiday, along with brief description.

Take note that the fields with asterisk (*) are required.

  • In the Name field, key in the name of the holiday.

  • In the From Date field, key in the next date of the holiday.

  • In the To Date field, key in the ending date of the holiday.

  • In the Repayment scheduled to field, key in the first business day following the holiday. This will allow loan payments to remain current should the regular due date fall on the holiday.

  • In the Description field, key in the description your organization uses for the holiday.

Expand the box next to Applicable office. The full list of offices will display. Click on each office affected by the holiday.

Review the information for accuracy, then click on Submit.

The Holiday will go into a "Pending for activation" status. An authorized user must review the holiday and activate it in the system.

5) Create Employees:

Click the blue Create Employee button at the top-right of the page to create a new employee.

Take note that the fields with asterisk (*) are required.

  1. Complete the required fields:

    a. Select the appropriate office from the drop-down menu

    b. First name

    c. Last name

    d. Designate the employee as a loan officer if that is the case

  2. Optional - Add a Mobile Number for SMS messaging.

  3. Provide the Joining Date of the employee.

  4. Click Submit.

6) Define Working Days

Now working days can be defined from front-end and it's easy to use. By just checking the check box to specify as working days & Un-check the box to specify as non working days,then click on Submit.

In the below image example: Monday,Tuesday,Wednesday,Thursday,Friday,Saturday are Working days & Sunday(Un-checked box) is a Non-working day.

Other Organization features will be used later in system set up and use.

  • Bulk Loan Reassignment - this is an operational field that allows the organization to reassign all loans from one loan officer to another. This field will be used in day-to-day operations. No initial set up is required.

  • Standing Instruction History - this will be used to track and search for standing transaction history.

  • Teller/Cash Management - this will be used to assign users to a cash drawer.

7) Create Data Tables

Mifos X data-table allows the user to add custom fields in addition to the built-in fields to a client profile, loan/saving account, group, center or a office. When creating a set of custom fields (i.e, data-table), you can set multi-row option to capture multiple instance of data. And custom field supports 6 data types (String , Number, Decimal, Date, Text and Drop down). Review the system provided data tables then, using your Pre-Configuration Guide, create additional fields in this area.

Select "Create Data table"

The Application table name field will provide a drop down of system functions the data table will affect. For example, if you are adding fields that will impact the Client level, click on Client.

Add Columns, enter name, from drop down select type (DBH - write this properly & tie in to pre config guide)

8) Define System Codes:

Codes are mostly system defined which means the code itself comes out of the box and cannot be modified however, its code values can be. e.g. 'Customer Identifier', it defaults to a code value of "Passport" but could be "Drivers License," "National Id" or any other ID acceptable to your organization.

9) Define Roles & Permissions:

Using the Pre-Configuration Guide, proceed through each function and click on the system privileges allowed by the position. It is important to take care when setting up User Roles as these will be used when setting up each individual employee.

In this example, an Operations Manager will be allowed to allocate cashier cash, create teller, etc. They will not be able to do any other loan transactions.

10) Create Users :

11) Configure Maker Checker Tasks :

12) Global Configuration:

Return to the Admin/System page, then select Configuration.

Global configuration related to set of supported enable/disable configurations:

  1. maker-checker - defaults to false - if true turns on maker-checker functionality

  2. allow-transactions-on-non_working days - defaults to false - if true allows transactions on non-working days

IMPORTANT - If you want to enable Accounting module, please set-up Accounting before moving to next step. If you don't want to setup Accounting module you could skip this step.

13) Accounting:

To Enable Accounting Module you need to follow below mentioned mandatory step by step instructions before you do any transaction:-

Step 4) Map your products with respective accounts - Once the Products are defined comeback to this section and follow the steps.

14) Define Charges:

In-either to attach charges to products, you need to define charges at this point. Later at the time of defining product, you could add charges by just selecting it from drop-down.

15) Define Products:

Products are set up once and are then available to qualifying clients (individuals, groups, and centers).

To define Products click on respective below mentioned links :

Others:-

Setting up your Fund Source:

If your organization has funds that are to be used for specific lending purposes, the names are defined here. In the example below the new fund "Rotary Internal Agriculture Loan 2014" has been entered into the "New Fund" field. Loans that are made to customer that fall into this category will link to the fund to enable the organization to properly monitor fund use and to provide reports. After the fund name has been entered, click on the + to add the fund to the list.

Across the top are the navigation drop downs. The Mifos logo will return the user to the from anywhere in the system. Overview:-

- drop down will be used to access individual accounts, groups and centers.

- drop down opens the menu to access the system tools required by the accounting departments.

- Drop down provides access to all areas of system reports including the default reports provided in the Mifos download and custom reports that will be developed by the organization.

- This is where the system is set up including users, organization, products and templates.

- This will allow the user to quickly navigate the system.

. - This will have settings,profile and help.

Follow this link to the page.

Using the information gathered in the , the first step is to create the Main Office of your organization. In this example, we use the name "Head Office". You enter the name that best describes your office name. This may be a building name, a road name or any other naming scheme your particular organization uses.

- Return to the Admin/Organization Screen.

Return to the Admin/Organization screen and Select .

Return to the Admin/Organization Screen and select

Return to the Admin/Organization Screen and select .

Return to the Admin/System Screen and select (Optional - For capturing additional details)

Return to the Admin/System Screen, then select - For defining system codes for examples - Payment types, Collateral, etc.

Review the list of system defined codes, then edit as needed for your operations. For more information on code configuration, see .

Return to the Admin/System Screen, then select

Return to the Admin Screen and select

Return to the Admin/System Screen, then select (Optional)

Mifos X Maker Checker functionality allows an financial institution to define transactions as having a maker and a checker phase. One user enters, deletes or changes data. Then, another user that has "Checker" rights for that transaction, can inspect and approve the data. By default, Maker Checker functionality is disabled. See to enable/disable Maker Checker functionality at a global level.

Additionally, Maker Checker functionality for each transaction (permission) is disabled by default. see to enable/disable Maker Checker functionality at a transaction (permission) level.

Finally, to give checking rights to a user (via a role associated with the user) see .

reschedule-future-repayments - defaults to false - if true reschedule's repayments which falls on a non-working day to configured repayment

reschedule-repayments-on-holidays - defaults to false - if true reschedules repayments which falls on a non-working day to defined

allow-transactions-on-holiday - defaults to false - if true allows transactions on

To access the menu and the options within, click on the Accounting button on the top of the screen:

Step 1) Create chart of accounts -

Step 2) Map opening balance contra account in -

Step 3) Pass opening balance entries -

Go to >> - Accounting

Go to >> - Accounting

Go to >> - Accounting

Go to >> - Accounting

Go to Admin>>Products Screen and select

To create charge, please refer link:-

Go to Admin>>.

(current and saving accounts)

Return to the Admin/Organization Screen and select .

Return to the Admin/System Screen, then select

There are numerous reports within the Mifos X system. Many are core reports that are pre-installed for your organization. Existing reports can be customized and new reports written. For details regarding report generation, see the section.

Welcome Page
Clients, Groups and Centers
Accounting
Reports
Administration
Global Search
Mifos dropdown
Manage Offices
Pre Configuration Plan.docx
Currency Configuration
Manage Holidays
Manage Employees.
Working Days
Manage Data Tables
Manage Codes
Manage Codes
Manage Roles and Permissions
Users
Configure Maker-Checker Tasks
Update Global Configuration
Enable/Disable Permissions for Maker Checker
Update a Role's Permissions
rescheduling rule
reschedule date
holidays
Accounting
Chart of Accounts - General Ledger Setup.
Accounts linked to Financial Activities
Migrate opening balances(Office wise)
Loan Products
Savings Products
Fixed Deposit Products
Recurring Deposit
Charges
Charges
Products
Loan Products
Savings Products
Fixed Deposit Products
Recurring Deposit
Manage Funds
Manage Reports
Manage Reports
General Navigation
Pre Configuration Plan.docx
Mifos X Installation on Windows
Mifos X Installation on Linux - Ubuntu Server