Creating multi-tenants

This page describes how to create another tenant.

The services are multi-tenant capable. Data is placed in separate databases for each tenant. Which tenant is addressed by a request is transmitted via the request header and via the bearer token. Any deployment may serve multiple tenants.

How to create another tenant for the same instance. This can be done by:

  1. Logging into the database using relevant credentials

  2. Creating a new database called fineract_test (could be any name, but must be prefixed with “fineract_”)

  3. Executing the following SQL query to add connection details for the new tenant to the fineract_tenants.tenant_server_connections table:

Where:

  • “fineract_test” is the name of the new tenant database

  • “root” is the username used to connect to the database

  • “mysql” is the password used to connect to the database

  1. Inserting into fineract_tenants.tenants table a new tenant:

Where:

  • “2” represents the new tenant connection id

  1. Restart the Tomcat server the application is running on.

Database name: fineract_test

Tenant Identifier: test

Community App URL e.g: https://YOURDOMAIN/?baseApiUrl=YOURDOMAIN:8443/fineract-provider&tenantIdentifier=test

Login Credentials as set (default):

  • Username: mifos

  • Password: password

Few relevant documentation to use here:

Last updated

Logo

Maintained by © Muellners Foundation. All Rights Reserved.