# Initial System Set Up

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 [General Navigation](/mifosx/user-manual/for-all-users/untitled.md). 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 [Pre Configuration Plan.docx](https://mifosforge.jira.com/wiki/download/attachments/73466161/Pre%20Configuration%20Plan.docx?version=1\&modificationDate=1442284208955\&cacheVersion=1\&api=v2)  at hand, follow these steps for first time log-in:

**Tip:** Need help downloading and/or installing the Mifos Community App? Please see the [Mifos X Installation on Windows](https://mifosforge.jira.com/wiki/spaces/docs/pages/53215236/Mifos+X+Installation+on+Windows) or [Mifos X Installation on Linux - Ubuntu Server](https://mifosforge.jira.com/wiki/spaces/docs/pages/74711072/Mifos+X+Installation+on+Linux+-+Ubuntu+Server)  section of this manual for more information.

### **1) Log-in into Mifos X:** 

#### **Sign in Page**

<figure><img src="/files/RTLLx4kSs04WmHKoyCPZ" alt=""><figcaption></figcaption></figure>

* Type username: mifos &#x20;
* Type password: password&#x20;
* Click "**Sign In"**

&#x20;**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. &#x20;

&#x20;Across the top are the navigation drop downs. The Mifos logo will return the user to the [Welcome Page](/mifosx/user-manual/for-all-users/untitled/welcome-page.md) from anywhere in the system. Overview:- &#x20;

* [**Clients, Groups and Centers**](/mifosx/user-manual/for-all-users/untitled/clients-groups-centers-navigation.md) **-** drop down will be used to access individual accounts, groups and centers.&#x20;
* [**Accounting**](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting.md) **-** drop down opens the menu to access the system tools required by the accounting departments.
* [**Reports**](/mifosx/user-manual/for-all-users/reports.md) **-** 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.
* [**Administration**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration.md) **-** This is where the system is set up including users, organization, products and templates.
* [**Global Search**](/mifosx/user-manual/for-all-users/untitled/global-search.md) **-** This will allow the user to quickly navigate the system.
* [**Mifos dropdown**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/mifos-dropdown.md). - This will have settings,profile and help. &#x20;

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

### **2) Set-up your Offices :**

Follow this link to the [Manage Offices](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/manage-offices.md) page.

<figure><img src="/files/mdr7a6y1oDqDUJevNFEH" alt=""><figcaption></figcaption></figure>

* Using the information gathered in the [Pre Configuration Plan.docx](https://mifosforge.jira.com/wiki/pages/viewpageattachments.action?pageId=52035605\&highlight=Pre+Configuration+Plan.docx#Community+App+-+A+user+interface+for+Mifos+X+APIs-attachment-Pre+Configuration+Plan.docx), 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.
* 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.

<figure><img src="/files/uyge4wmdwkKPtc1eOu29" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DITdMO3k17oDMoR7I4xT" alt=""><figcaption></figcaption></figure>

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.

&#x20;**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.**&#x20;

### **3) Configure Currency:**

&#x20; [Currency Configuration](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/currency-configuration.md) *-* Return to the **Admin/Organization** Screen.

<figure><img src="/files/oOi4jdMP6wvjYyQp9r7I" alt=""><figcaption></figcaption></figure>

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

### **4) Define Holidays:**

&#x20;Return to the **Admin/Organization** screen and Select [Manage Holidays](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/manage-holidays.md).

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.&#x20;

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

<figure><img src="/files/4dsY7Z8rIv9du1HFe3Tk" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OPSch5J7DSCOd7n5Ix8H" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sEJw3XxYfZamzQiVrSCa" alt=""><figcaption></figcaption></figure>

* &#x20;In the **Name** field, key in the name of the holiday.
* &#x20;In the **From Date** field, key in the next date of the holiday.
* &#x20;In the **To Date** field, key in the ending date of the holiday.
* &#x20;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.
* &#x20;In the **Description** field, key in the description your organization uses for the holiday.

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

&#x20;Review the information for accuracy, then click on **Submit.**

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

### **5) Create Employees:**

Return to the **Admin/Organization** Screen and select [**Manage Employees.**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/manage-employees.md)

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.**

<figure><img src="/files/Pc1zl85SFg80jXlIENK2" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/a1plcbuoYOAWnAxup5Yf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/XTz4UbsMdnkwCE8ia5U1" alt=""><figcaption></figcaption></figure>

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.&#x20;
4. Click **Submit**.

### **6) Define Working Days**

Return to the **Admin/Organization** Screen and select  [**Working Days**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/working-days.md)**.**&#x20;

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.&#x20;

<figure><img src="/files/1e45kaFXDnf0L1oN1VYx" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/B6KLaMq9foZEPnx5mdIe" alt=""><figcaption></figcaption></figure>

**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. &#x20;

### **7) Create Data Tables**

&#x20;Return to the **Admin/System** Screen and select  [**Manage Data Tables**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-data-tables.md)  **(Optional - For capturing additional details)**

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.

&#x20;Select "**Create Data table**"

<figure><img src="/files/FD9iJf2Xp907TT99n46z" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/rE5RC50adTxk8E4zee8g" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aFararHChNgIodSWhwAJ" alt=""><figcaption></figcaption></figure>

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:**

&#x20;Return to the **Admin/System** Screen, then select [**Manage Codes** ](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-codes.md) - For defining system codes for examples - Payment types, Collateral, etc.

<figure><img src="/files/eGnMjR9rw3QcJ9Pbqf28" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wxhn8FWioa991yIeJDE1" alt=""><figcaption></figcaption></figure>

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.

Review the list of system defined codes, then edit as needed for your operations.  For more information on code configuration, see [**Manage Codes**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-codes.md)**.**

<figure><img src="/files/mpwVLC5ljkhBvyRvicoo" alt=""><figcaption></figcaption></figure>

### **9) Define Roles & Permissions:**

Return to the **Admin/System** Screen, then select [**Manage Roles and Permissions**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-roles-and-permissions.md)

<figure><img src="/files/dO6dSszT56zhCdYREgAc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yuYge3rRTywNeUiF0PVy" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/bTSOvDluK3PDDnfYlCdm" alt=""><figcaption></figcaption></figure>

![](/files/-Lf1GVu7Q_6AiOBS6RqV)

### **10) Create Users :**

Return to the **Admin Screen** and select [**Users**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/users.md)&#x20;

<figure><img src="/files/GShiV0fUmSnCo6I9JejL" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MmXDZMmYoAjbzzDp9tsG" alt=""><figcaption></figcaption></figure>

### **11) Configure Maker Checker Tasks :**

Return to the **Admin/System** Screen, then select [**Configure Maker-Checker Tasks**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/configure-maker-checker-tasks.md) (Optional)&#x20;

<figure><img src="/files/bXqjl6gIUBdQfJqJ7RCJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6FrfDqKtLYtF3HZJHoiD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OVZ8BDSFxpnDBrf6iaCh" alt=""><figcaption></figcaption></figure>

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 [Update Global Configuration](https://demo.openmf.org/api-docs/apiLive.htm#configs_globalconfig_update) to enable/disable Maker Checker functionality at a global level.

Additionally, Maker Checker functionality for each transaction (permission) is disabled by default. see [Enable/Disable Permissions for Maker Checker](https://demo.openmf.org/api-docs/apiLive.htm#permissions_update) 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 [Update a Role's Permissions](https://demo.openmf.org/api-docs/apiLive.htm#rolespermissions_update).&#x20;

### **12) Global Configuration:**

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

<figure><img src="/files/AA3RmD1bc2EqGrwVNOgk" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Z75eFpbim1DyEdXfuQnD" alt=""><figcaption></figcaption></figure>

&#x20;Global configuration related to set of supported enable/disable configurations:

1. **maker-checker** - defaults to false - if true turns on maker-checker functionality
2. **reschedule-future-repayments** - defaults to false - if true reschedule's repayments which falls on a non-working day to configured repayment [rescheduling rule](https://demo.openmf.org/api-docs/apiLive.htm#nw_repayment_schedule_rule)
3. **allow-transactions-on-non\_working days** - defaults to false - if true allows transactions on non-working days
4. **reschedule-repayments-on-holidays** - defaults to false - if true reschedules repayments which falls on a non-working day to defined [reschedule date](https://demo.openmf.org/api-docs/apiLive.htm#holidays)
5. **allow-transactions-on-holiday** - defaults to false - if true allows transactions on [holidays](https://demo.openmf.org/api-docs/apiLive.htm#holidays)&#x20;

> &#x20;**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. &#x20;

### **13) Accounting:**

&#x20;To access the [**Accounting**](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting.md) menu and the options within, click on the **Accounting** button on the top of the screen: &#x20;

<figure><img src="/files/UvFGGIRW0L2pDwNlqSUo" alt=""><figcaption></figcaption></figure>

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

Step 1) Create chart of accounts - [Chart of Accounts - General Ledger Setup.](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/chart-of-accounts-general-ledger-setup.md) &#x20;

Step 2) Map opening balance contra account in - [Accounts linked to Financial Activities ](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/accounts-linked-to-financial-activities.md)&#x20;

Step 3) Pass opening balance entries - [Migrate opening balances(Office wise)](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/migrate-opening-balances-office-wise.md) &#x20;

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

* Go to >> [Loan Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products.md) - Accounting&#x20;
* Go to >> [Savings Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/untitled.md) - Accounting&#x20;
* Go to >> [Fixed Deposit Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/fixed-deposit-products.md) - Accounting&#x20;
* Go to >> [Recurring Deposit](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/recurring-deposit.md) - Accounting  &#x20;

### **14) Define Charges:**

Go to **Admin>>Products** Screen and select [**Charges** ](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/charges.md)

<figure><img src="/files/9J1VvUO4BHemPGBDBZFj" alt=""><figcaption></figcaption></figure>

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.&#x20;

To create charge, please refer link:- [**Charges** ](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/charges.md)

### **15) Define Products:**

&#x20;Go to **Admin>>**[**Products**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products.md)**.**

<figure><img src="/files/UZkGVonQ7KKfUOFejQaO" alt=""><figcaption></figcaption></figure>

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 :&#x20;

* [Loan Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products.md)
* [Savings Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/untitled.md) (current and saving accounts)
* [Fixed Deposit Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/fixed-deposit-products.md)
* [Recurring Deposit](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/recurring-deposit.md)&#x20;

### Others:-&#x20;

### **Setting up your Fund Source:**

Return to the **Admin/Organization** Screen and select [**Manage Funds**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/manage-funds.md)**.**&#x20;

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.

<figure><img src="/files/vdHeG7SNdJrLx1P9PciC" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7A4Ww5sFc0LuhxETYOBY" alt=""><figcaption></figcaption></figure>

&#x20;Return to the **Admin/System Screen**, then select [**Manage Reports**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-reports.md)&#x20;

<figure><img src="/files/A5x8eWBXI5D3dj2IZzfd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/M0kAx0a8iDjgc91ODM7h" alt=""><figcaption></figcaption></figure>

&#x20;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 [**Manage Reports**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-reports.md) section.  &#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/initial-system-set-up.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.