Installation Guide

Installation Guide

This guide covers production-style installation of Fintegrator TODS on Kubernetes with Helm.

Prerequisites

• Kubernetes cluster (supported by your platform team)
• kubectl access to the target cluster
• Helm v3
• Access to required container images
• Environment-specific secrets file (values.secrets.yaml)
• Permission to create namespace, secrets, and workload resources

1 Add Helm repository

helm repo add morphflow https://docs.fintegrator.eu/tods
helm repo update

2 Prepare secrets values

Create a local secrets file from the template and populate required values.

cp values.secrets.example.yaml values.secrets.yaml

Use placeholders in this file such as:

• <api-base-url>
• <keycloak-client-secret>
• <database-connection-string>

3 Install latest chart

helm upgrade --install morphflow morphflow/morphflow \
  -n morphflow --create-namespace \
  -f values.secrets.yaml

4 Install stable image set

helm upgrade --install morphflow morphflow/morphflow \
  -n morphflow --create-namespace \
  --set morphapi.image.tag=stable \
  --set morphtool.image.tag=stable \
  --set morphofs.image.tag=stable \
  --set morphdbDeployer.image.tag=stable \
  -f values.secrets.yaml

5 Install a specific chart version

helm upgrade --install morphflow morphflow/morphflow \
  -n morphflow --create-namespace \
  --version 26.0.6 \
  -f values.secrets.yaml

6 Verify deployment

kubectl get pods -n morphflow

Optionally verify service and ingress resources:

kubectl get svc,ingress -n morphflow

Check Helm release status:

helm status morphflow -n morphflow

Optional OCI install

helm upgrade --install morphflow \
  oci://ghcr.io/fintegrator-ltd/tods/charts/morphflow \
  -n morphflow --create-namespace \
  --version 26.0.6 \
  -f values.secrets.yaml

Upgrade and rollback

Upgrade by rerunning the same helm upgrade --install command with a new chart version or image tags.

If needed, roll back safely:

helm rollback morphflow 1 -n morphflow