Mifos Gazelle is a Mifos Digital Public Infrastructure as a Solution (DaaS) deployment tool v2.0.0 — March 2026. Deploys MifosX (core banking), Payment Hub EE (payment orchestration), and Mojaloop vNext Beta1 (payment switch) on Kubernetes with a single command.
Latest Stable Release (Ubuntu/Linux):
git clone --branch main https://github.com/openMF/mifos-gazelle.git
cd mifos-gazelle
sudo ./setup-env.sh -e local -u $USER # one-time: k3s, tools, /etc/hosts
./run.sh -m deploy -a all # deploy (no sudo needed)See Deployment Guide for prerequisites and full instructions.
To also deploy OpenG2P (Government-to-Person payments), enable it in config/config.ini and run ./run.sh -m deploy -a openg2p. With the whole stack up, the PBMS UI runs a full G2P bulk disbursement end to end, from beneficiary registry through Payment Hub into MifosX. See OpenG2P for details.
To deploy OpenSPP (social registry, OpenSPP2 / Odoo 19) run ./run.sh -m deploy -a openspp. It is off by default and pulls its images, so there is nothing to build on amd64. With the whole stack up, bash demos/openspp/run_demo.sh runs an agri subsidy end to end, from OpenSPP through Payment Hub into MifosX. See OpenSPP for details.
For Latest Development Release (May not be stable):
git clone --branch dev https://github.com/openMF/mifos-gazelle.git
cd mifos-gazelle
sudo ./setup-env.sh -e local -u $USER
./run.sh -m deploy -a all| Guide | Contents |
|---|---|
| Deployment Guide | Install, configure, test end-to-end payments, FAQ |
| Bulk Payment Tools | Submit/verify G2P batch payments, GovStack mode |
| GovStack Architecture | G2P bulk disbursement design and troubleshooting |
| OpenG2P | Deploy OpenG2P G2P payments (commons, PBMS, social-registry, SPAR, g2p-bridge), the step-by-step bulk disbursement demo, and building OpenG2P images |
| OpenSPP | Deploy OpenSPP2 (Odoo 19) social registry: quick start, configuration, first steps and the agri demo |
| Local Development | hostPath mounts for iterating on Payment Hub EE code |
| vNext Standalone | Deploy Mojaloop vNext on its own |
| Raspberry Pi | Ubuntu setup on Raspberry Pi 5 |
| Release Notes | v2.0.0 changes and component versions |
| PHEE Release History | reference for PaymentHub EE component versions |
| Mastercard CBS | Cross-border payment connector for Payment Hub EE — overview, integration, and quick start |
| Mastercard CBS — Operator Guide | Full config reference, CR spec, operator lifecycle, and troubleshooting |
| Building Images | Build an image for the host architecture and load it into the cluster |
- Demo Creator — TUI to author, manage, and deploy Gazelle demos
- Demo Runtime — Web UI to run interactive demos against a live Gazelle deployment
- Contributing Guidelines
- License Information
- Architecture
- Mifos Slack for Release — join the
#mifos-gazellechannel - Mifos Slack for Development — join the
#mifos-gazelle-devchannel