This site provides hosting for Apache Fineract, and runs the code from github.com/apache/fineract as a service.

Usage

Open the Community App UI (older, but more complete; see github.com/openMF/community-app) or the Web App UI (newer, see github.com/openMF/web-app) and login with e.g. mifos/password.

You can also directly invoke Apache Fineract’s REST API backend on this server; e.g. via /api/v1/clients or the api/v1/audits etc. or by using the new Swagger UI (or directly use Fineract’s Swagger YAML in a tool). Again, always login with e.g. mifos/password to the REST API, just like the UI.

Frequently Asked Questions (FAQ)

Is this free? The demo instance is and always will be free.

Who pays for hosting this? vorburger@ originally paid for it personally. Google Cloud hosting costs for this demo site were graciously offered by Google Open Source from mid October 2021 to 2022. The demo instance is currently stopped; please reach out to hosting@fineract.dev if you would like to discuss bringing it back alive.

Can I do whatever I like on the demo instance? Sure! Just to avoid any misunderstanding about what a demo is, and is not: The database of the default tenant on the demo may be completely wiped about once a week by an automated script!

Can I get a persistent non-demo tenant or full instance here? We’re still thinking this through. Should you have an interest in a non-demo instance of Apache Fineract, please reach out to hosting@fineract.dev - we’re interested in understanding the need and expectations in this space.

What version of code does this run? This server uses CI/CD and always automatically updates itself from the very latest source code available on the develop branch of Fineract (FINERACT-970). You can verify this for yourself by checking the /actuator/info API, which returns the exact Git commit revision that is running. (New deployments take about 15’ after we merge Pull Requests.)

How well tested is the code that this site runs? All running code has passed all of Fineract’s unit and integration tests of the respective code branch. (Any unstable tests which had to be disabled during development, are therefore, of course, not run before code deploys to this server.)

What hardware, OS, DB etc. is this server running on? It’s actually not really a “server”, but runs on latest generation modern cloud infrastructure. The Running Fineract.dev, SRE style presentation given at ApacheCon has some background (and this blog post about how to manage GitHub secrets on repos you only have Write but not Admin). The exact details shouldn’t matter to users, and they may change over time, so we don’t explain them in details here. The DB is MySQL 8.0 on Google Cloud SQL (since #8), and using the MariaDB (not MySQL, nor Drizzle; see FINERACT-982) JDBC driver that Fineract includes in its Docker container.

Can I get access to the Fineract logs from this server? It depends. If you are an active Apache Fineract committer and want to help with FINERACT-932 kind of work and could benefit from access to Google Cloud Error Reporting for this server, then yes - just ask.

If this runs on the cloud, will it be always available? The cloud infrastructure that this runs on is very reliable, and will e.g. “auto heal” and restart crashed instances. The HTML/JS is served from a world-wide content distribution network (CDN). We use top notch industry standard Site Reliability Engineering (SRE) best practices such as monitoring metrics etc. to keep an eye on this server. But here is a fun idea: Try to crash our demo - and if you manage, then work with us in the open source project to make the Fineract code more scaleable and reliable!

Is this open source? The Fineract and UI code that runs here of course is. Many improvements made to be able to run this site already have been and will continue to be made “upstream first”. The hosting setup itself is mostly manual, and there is nothing much there to share that would make much sense. The web page itself you are reading is on GitHub, and you are welcome to propose any improvements to it through a pull request.

Can you help me set up a server like this for our own use? Depends what exactly you mean by that. We haven’t been able to figure out how to explain the details of how this runs and make it an effective use of your and our time. Having said that, please see the earlier questions about using this server for non-demo purposes. If that is not an option for you, we would be interested in understanding why.

Is this Mifos? Two things here: 1. Mifos X is the old name of the code which now lives on at https://github.com/apache/fineract at the ASF. In that sense, yes, this server runs (the current version of the code origially known as) Mifos. 2. The Mifos.org Initiative is the organization which originally helped move Mifos X to the Apache Foundation, and which continues to actively support the Apache Fineract project in many ways.

Is this an Apache Software Foundation project? Apache Fineract sure is! This hosting website is not.

Is this Fineract CN? No, this site curently runs only Fineract.

Contact & Support

You’ll most likely want to use a partner to assist you with implementing Apache Fineract software for your organization.

For community support by volunteers about how to use Apache Fineract, use:

To add new features and fix bugs blocking you in Fineract, you are cordially invited to be an active open source contributor to the Apache Fineract project. Alternatively you can pay someone to do so for you; you can meet some of the parties interested in working with you on the mailing lists.