apache / fineract

# Apache Fineract
Apache Fineract is an open-source core banking platform providing a
flexible, extensible foundation for a wide range of financial services. By
making robust banking technology openly available, it lowers barriers for
institutions and innovators to reach underserved and unbanked populations.
Have a look at the documentation, the wiki or at the FAQ, if this README does not answer what you are looking for.
COMMUNITY
=========
If you are interested in contributing to this project, but perhaps don't quite know how and where to get started, please join our developer mailing list and chat server, listen into our conversations, chime into threads, or just send us a "Hello!" introduction message; we're a friendly bunch, and look forward to hearing from you.
For the developer wiki, see Contributor's Zone. Maybe these how-to articles help you to get started.
In any case visit our JIRA Dashboard to find issues to work on, see what others are doing, or open new issues.
In the moment you get started writing code, please consult our CONTRIBUTING guidelines, where you will find more information on subjects like coding style, testing and pull requests.
REQUIREMENTS
============
See Fineract Development Environment in the docs for hardware, software, and tool prerequisites and recommendations.
SECURITY
============
For a list of known vulnerabilities, see Apache Fineract Security Reports.
If you believe you have found a new vulnerability, let us know privately.
For details about security during development and deployment, see the documentation here.
PRIVATE FORKS
============
If you’re running Apache Fineract on a private fork, you might want to consider **disabling GitHub Actions CI**. 
This is because the usage minutes and artifact costs (including the built workspace and logs generated during execution) could incur additional expenses, that you should be aware!
INSTRUCTIONS
============
Quick Start
---
Follow these steps to quickly set up and run Apache Fineract locally.
### Prerequisites
- Java JDK
- PostgreSQL running locally, listening on port 5432 with proper permissions (see below for how to run PostgreSQL in Docker)
 [code] 
After a minute or two, Fineract will be listening for API requests on port 8443.
Wait for the `APACHE FINERACT IS READY` message in the log before sending requests.
Stopping a `bootRun` or `devRun` process is reported by Gradle as `Build cancelled while executing task`, but that does not mean that Fineract failed.
A graceful shutdown is also logged, as `APACHE FINERACT IS SHUTTING DOWN GRACEFULLY`.
> [!TIP]
> Java properties or environment variables can be used to override default settings. See `fineract-provider/src/main/resources/application.properties`.
### Verify the application is running
Confirm Fineract is ready with, for example:
 [code] 
Expected response for fresh instance:
 [code] 
To test authenticated endpoints, include credentials in your request:
 [code] 
Expected response for fresh instance:
 [code]