# Custom Installations

## Rolling your own helm chart

The best approach would be to take one of the tested Lab Environment examples from below and start customizing it to the actual requirements. Once the configuration looks proper, proceed with the deployment as detailed above. Note that very specific charts are in env-labs and generic/ use-case charts are in env-templates.

## Some basic information for payment hub helm charts:

## ph-ee-env-templates: 

[ph-ee-env-template](https://github.com/openMF/ph-ee-env-template) is the parent chart used for the deployment of various paymentHub services. This chart contains the default configuration for every service. In paymentHub this chart is termed as ph-ee-engine.

#### ph-ee-env-templates cookbooks:

* g2p-sandbox
* identity-account-mapper

## ph-ee-env-labs:

[ph-ee-env-labs](https://github.com/openMF/ph-ee-env-labs) is the chart repository used to alter the default configuration of the ph-ee-engine(ph-ee-env-templates) chart. This repository contains various cookbooks as per the user's requirement.

#### ph-ee-env-labs cookbooks:

* ph-ee-fin-back-end
* ph-ee-fin-front-end
* operations

### How to install cookbooks:

> Your current directory should be in ph-ee-env-labs/ ph-ee-env-templates depending on which chart you're installing.

#### ph-ee-fin-back-end installation:

Steps to install ph-ee-fin-back-end chart:

1. Build the chart dependency:

```
helm dep up helm/ph-ee-fin-back-end
```

2. Install the helm chart:

```
helm upgrade -f helm/ph-ee-fin-back-end/values.yaml RELEASE_NAME helm/ph-ee-fin-back-end/ --install --create-namespace --namespace NAMESPACE
```

> Enter appropriate RELEASE\_NAME and YOUR\_NAMESPACE in the above command.

3. Install the elastic secrets required for the services:

```
make elasticSecrets
```

4. Install the kibana secrets:

```
make kibanaSecrets
```

Now you are good to go with ph-ee-fin-back-end chart.

#### ph-ee-fin-front-end installation:

Steps to install ph-ee-fin-front-end chart:

1. Build the chart dependency:

```
helm dep up helm/ph-ee-fin-front-end
```

2. Install the helm chart:

```
helm upgrade -f helm/ph-ee-fin-front-end/values.yaml RELEASE_NAME helm/ph-ee-fin-front-end/ --install --create-namespace --namespace NAMESPACE
```

### Ways to connect to External RDBMS:

To use the external RDBMS service for any of the cookbooks just need to follow below steps:

> Here is an example of ph-ee-fin-back-end chart.

1. Open values.yaml of ph-ee-fin-back-end chart in an editor.
2. Replace HOST\_NAME, USER, and PASSWORD with your external RDBMS hostname, user, and password.

```
operations_app:
    enabled: true
    imageTag: "latest"
    SPRING_PROFILES_ACTIVE: "bb"
    tenants: "gorilla,lion, phdefault"
    hostname: "ops-bk.sandbox.mifos.io"
    datasource:
      username: USER
      password: PASSWORD
      host: HOST_NAME
      port: 3306
```

> Replace all the other occurrence of datasource with the external RDBMS details. e.g: importer\_rdbms, messagegateway, etc.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mifos.gitbook.io/docs/payment-hub-ee/overview/installation-instructions/custom-installations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.