A few months ago I blogged about the basic new Mifos executable WAR (based on MariaDB4j and Spring Boot). This post shows step by step how to use this simple standalone package deployment option, from scratch, if you would like to easily get the Mifos X platform incl. UI (MIFOSX-1756) running, on Windows, Linux or Mac OS X. (For more elaborate custom deployments, you or your Mifos X deployment partner probably want to learn about how to do the slightly more complicated "classic" WAR deployment using an EE Web Servlet container such as Tomcat, Jetty, WebLogic, WebSphere and an external database; this article outlines how to use a simpler self contained all-in-one route which incl. the database etc. Also, note the Mifos X Debian package, and its video.)
To build the Mifos X package from scratch yourself is easy:
1. Obtain the source code of the Mifos X API Java-based back-end platform (non-UI) from https://github.com/openMF/mifosx. You can "git clone" it from there, or alternatively you may simply download it from https://github.com/openMF/mifosx/archive/develop.zip.
2. Unzip, cd mifosx/mifosng-provider, and run gradlew -Penv=dev dist (this will download some stuff)
3. copy mifosx/mifosng-provider/build/distributions/mifosplatform-*.RELEASE.zip SOMEWHERE
To now use such a Mifos X package with a UI is equally easy:
1. unzip mifosplatform-*.RELEASE.zip
2. cd mifosplatform-*
3. cd apps
4. Obtain the source code of the Mifos X AngularJS-based UI from https://github.com/openMF/community-app. You can "git clone" it from there, or alternatively you may simply download it from https://github.com/openMF/community-app/archive/develop.zip, and unzip it into the apps/ directory (so you'll have a mifosplatform-*/apps/community-app/app/ ... folder).
5. java -jar mifosng-provider.war
Now check out https://localhost:8443/mifosng-provider/api/v1/offices?tenantIdentifier=default and see the REST API is up (default login is mifos / password), and open https://localhost:8443/mifosng-provider/apps/community-app/app/index.html?baseApiUrl=https://localhost:8443&tenantIdentifier=default#/ to see the UI.