Skip to end of metadata
Go to start of metadata

For Video guide - Click on the below link

On this page:

Prerequisite Software's   

 Note:- Below are mandatory prerequisite software's with mentioned versions only

  • JAVA DEVELOPMENT KIT >> VERSION 1.8.0_65 & above                                
  • MYSQL SERVER >> Version 5.5 or 5.6
  • TOMCAT >> Version & above
  • Install Java 

1) Before beginning, uninstall any existing versions of Java currently on your computer. 

2) In your web browser, go to, to download JAVA 1.8.

3) Oracle requires that you read the license agreement, then click the button labeled Accept License Agreement.

4) Click the link to download with respect to you system architect i.e Windows x86 for 32bit or Windows x64 for 64bit. 

5) Save the Java installation file to your computer

6) Run & install the Java file.

  • Install MySQL  

1) In your web browser, go to download MYSQL server 5.5v.

Click on download button with respect to you system architect i.e Windows x86 for 32bit or Windows x64 for 64bit.

2) You can skip this option by clicking the link at the bottom of the page that says No thanks, just start my download. 
& Click on the Save file to your system.


 3) Run the MySQL installation file.Click on Typical button and click on Next button.


4) During MySQL installation, use Advanced Configuration > Show Advanced Options & set the MySQL ROOT Password to mysql. Then click on Save button.So your user name will be root and password will be mysql.

  • Install Tomcat

1) In your web browser, go to to download tomcat 7.

 >> Under the section Binary Distributions>>Core, click on the link 32-bit windows zip or 64-bit windows zip( with respect to your system architect) to download.


2) Extract 


  4) Folder: apache-tomcat-7.0.68, gets extracted:-      

5) Copy & Paste apache-tomcat-7.0.68 folder to c:\(drive) then Rename it to tomcat 

  • Create Environment Variables 

1) Open your Environment Variables:
Start Menu > Control Panel > System and Security > System > Advanced System Settings > Environment Variables.

2) Create JAVA_HOME variable:
  • Click on the New button, under the User Variables section.
  • For Variable Name, enter JAVA_HOME
  • For Variable Value,Provide the Java path for example:- C:\Program Files\Java\jdk1.8.0_66
    i - If you are running 32-bit Windows, then the path would be ex:- C:\Program Files (x86)\Java\jdk1.8.0_66
    ii - Java jdk path "jdk1.8.0_66" will be with respect to the installed version and it may not be the same as mentioned in the above example. 
  • Click the OK button.
3) Edit PATH variable:
  • In the System Variables section, scroll down to and select the Path variable.
  • Click the Edit button just below.
  • Click your mouse cursor into Variable Value box. 
    Using your keyboard's right-arrow or End key, move all the way to the far right of the current text in Variable Value.
  • Add the following text onto the end of the existing Variable Value text: 
    - For Java path example:- ;C:\Program Files\Java\jdk1.8.0_66\bin 
    - For Mysql server path example:- ;C:\Program Files\MySQL\MySQL Server 5.5\bin

    i - There must be exactly one semi-colon between whatever is already in your PATH variable, and the new C:\Program Files\Java\jdk1.8.0_66\bin – don't add a semi-colon if your previous PATH already ended with a semi-colon.
    ii - Java jdk path "jdk1.8.0_66" will be with respect to the installed version and it may not be the same as mentioned in the above example. 

  • Click the OK button  

4) Create JAVA_OPTS variable: 

  • a. Click the New... button again, under the User Variables section.
  • b. For Variable Name, enter JAVA_OPTS
  • c. For Variable Value, example -Xms512m -Xmx1024m
    Note: Variable value example can be changed with respect to the system memory size for example: -Xms512m -Xmx1024m 
  • Download Mifos 

1) Go to from your web browser & Navigate to Take Action >> Get Mifos 
2) Click on the "DOWNLOAD IT ON YOUR OWN

3) Click on "Download MifosX Now 

4) Kindly fill the Application form with basic information on Mifos Download Form, then click the Next Page button.

(NOTE: You could skip this part, by going to the bottom of the page,then click on:

No thanks. I would just like to download Mifos without providing additional information.) The download will automatically start.

However we would like to understand & serve you better if you can provide your organization details.


5) You will automatically navigate to a download page for Mifos on the Sourceforge website, where you will be prompted to download the Mifos application files in a ZIP format.

Note:- You could also download other versions directly from:


6) Once you have download the Mifos ZIP file, extract it to a new folder on your computer.  Remember this location, as you will need to refer to it later. 

  • Initialize MySQL data 

1) Download HEIDISQL from:- & Save the installation file to your computer.

2) Run the Heidisql installation file & setup Heidisql: 

i) For local - Provide mysql password as mysql

ii) Click on Save button.

iii) Click on open button. 


4) Copy the following database command and paste it into the large white box titled Query
create database `mifosplatform-tenants`; create database `mifostenant-default`; use `mifosplatform-tenants`;

5) Click on Run button to Execute the query. . 


6) On heidisql, click on File>>Load SQL file..

7) Through Load SQL file window,

  • Navigate to the location where you extracted the Mifos application files.
  • Navigate to the database folder, inside that location.
  • Select the file mifospltaform-tenants-first-time-install.sql and click Open.

Run the first-time-install script, by clicking Run Query button & once its successful close heidisql application.

  • Tomcat - Setup

1) Setting up Lib folder

a) Download mysql jdbc 5.1.27 jar file from

b) Once it's downloaded copy & paste it to lib folder, Go to Tomcat>>lib folder. 

Note: If tomcat-jdbc.jar file is not available in the tomcat>>lib folder then you could download and paste it from:

2) Generate keystore

 Generate a new keystore using java keytool :

>> Open command prompt 
>> Go to the path where your JAVA>>bin folder is located. 
>> Run this command to generate the key: keytool -genkey -alias tomcat -keyalg RSA
>> Then provide the password. 
For example: 

Provide input and type in y for the last question to confirm. 

Note: Once the keystore is created, it should be placed in your home directory. For Example: C:/Users/john/.keystore

3) Configure server.xml page,

a) Go to  tomcat>>conf>>open server.xml with notepad:

b) Delete everything in it and copy-paste the following right side entire content of the page code:

c) Once content is pasted in server.xml, Below mentioned are to be modified with respect to your system & settings:
i - Key store path should be modified with your key store path location Example:- keystoreFile="C:/Users/john/.keystore"
ii - Key store password (which was provided while creating the key), should be modified Example:- keystorePass="xyz123"
iii - MYSQL credentials should be modified
Example:- username="root" & password="mysql"                                                                                                     

<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

<Resource name="UserDatabase" auth="Container"
description="User database that can be updated and saved"

<Resource type="javax.sql.DataSource"
validationQuery="SELECT 1"

<Service name="Catalina">

<Connector protocol="org.apache.coyote.http11.Http11Protocol"
port="443" maxThreads="200" scheme="https"
secure="true" SSLEnabled="true"
clientAuth="false" sslProtocol="TLS"

<Engine name="Catalina" defaultHost="localhost">

<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".log"
pattern="%h %l %u %t &quot;%r&quot; %s %b" />


4) Save modified server.xml page

Press Ctrl + S or File>Save. 

 5) Close Notepad. 


If your any of the server port connections are using port number = 443, then you need to change your port number to 8443, in server.xml here:-

port="443" maxThreads="200" scheme="https" to port="8443" maxThreads="200" scheme="https" 

  • Drop Mifos into Tomcat folder

1) fineract-provider.war to tomcat>>webapps folder

1-a) Copy "fineract-provider.war" file from downloaded fineract-platform folder 



1-b) Paste it to tomcat\webapps folder


2) Community-app to tomcat>>webapps folder

2-a) Copy "community-app" folder from downloaded Mifos-platform>>apps folder: 


2-b) Paste it to tomcat\webapps

2-c) Rename existing ROOT folder to OLDROOT under tomcat\webapps\

2-d) Rename community-app folder to ROOT

3) api-docs to tomcat>>webapps>>ROOT folder

3-a) Copy "api-docs" folder from downloaded Mifos-platform>>api-docs folder: 


3-b) Paste it to tomcat\webapps\ROOT folder

  • Create .mifosx folder

1) Create .mifosx folder in home directory & paste Pentaho folder into it

Use command prompt for creating .Mifos folder i.e md .mifosx


2) Copy PentahoReports folder from downloaded Mifos-platform folder


3) Paste it to .mifosx folder


  • Start Mifos   

1) Go to "C:\tomcat\bin" folder, Run "startup.bat" by clicking it.


Note: You can create a shortcut  of "startup.bat" on your desktop and rename it as start mifosx.  

2) Application gets started


3) Once server starts, will display as "Server startup in xxxxx ms"


4) You could access through any internet browser:- 

@ https://localhost 

and if you are using server port number as 8443 then you could access it @ https://localhost:8443

 5) For the first time access it will display as shown below, please click on proceed:- 


6) Login into Mifos, Provide user name: mifos and password as: password



Stop Mifos X

You could stop by pressing ctrl+c key on tomcat server window & Mifos X gets stopped.
  • Platform application should be available @ https://[public DNS]/fineract-provider/api/v1/offices?tenantIdentifier=default&pretty=true, and this API should return JSON format text with office details
  • API docs should be available @ https://[public DNS]/api-docs/apiLive.htm


  1. java sql sqlexception access denied for user root localhost using password yes

    The above error during installation when one does not  update the default credentials for connecting to *mifoplatform-default* database stored in the *tenants* table of *mifosplatform-tenants* with your credentials.

    Script: ....

    UPDATE tenants SET schema_username = "your_username", schema_password = "your_password" WHERE identifier = "default";

    1. I m install on https://localhost:8433 Mifos X Client and i cant login.In tutorial  with this - Login into Mifos, Provide user name: mifos and password as: password.

  2. Hey please update Generate keystore section to keytool -genkey -alias tomcat -keyalg RSA -keysize 2048 to avoid ssl issues with newer versions of web browsers. See:

    1. Thanks for the feedback, same has been updated in the Tomcat Setup>Generate kyestore

  3. can't login to mifos using credentials mifos as username and password as password.

    Please help. I am a new user

  4. bonjour, j'ai suivi le tutorielle tel quelle est mais ça marche pas quand je mets l'adresse au navigateur ça me donne une erreur connexion à échoué merci d'avance pour votre réponse.