Home

mifosx

This page lists out the instructions for getting started on mifosx for Developers.

Github & Git

see Github-&-Git

Gradle Setup

see Gradle setup

Eclipse Setup

see Eclipse setup

Database setup

see MySQL database setup

Launching platform server locally from the command line

Commands

Open up a terminal/command prompt.

On terminal, move into the mifosng-provider directory and execute gradle clean tomcatRunWar

If all has gone well, the platform should be available at: https://localhost:8443/mifosng-provider/api/v1/offices?tenantIdentifier=default

You should be able to log into platform with Username: mifos and Password: password.

For client applications built on top of the platform see the https://github.com/keithwoodlock/mifosx-community-apps repository.

If Using Different MySQL User/Password than what is configured

Note: When launching the platform from the command line for developement, the user/password used for the database is root/mysql. If your root user password for mysql is different, you should change the password in the file mifosng-provider/src/test/resources/META-INF/context.xml

Also, see MySQL database setup which also requires some actions if using a user/password different to root/mysql.

Troubleshooting Help

BindException Errors

If you get the java.net.BindException: Address already in use :8080 exception whilst running the gradle command inside the mifosng-provider directory, you may need to kill the process which is already using 8080 (netstat -aon | grep 8080).