> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployment guidelines v5.9.1

> Component versions, configuration, and deployment notes for FlowX.AI 5.9.1 (5.9.x LTS maintenance release).

<Info>
  After upgrading to a new platform version, always ensure that your installed component versions match the versions specified in the release notes. To verify this, navigate to **FlowX.AI Designer → Platform Status**.
</Info>

## Upgrade overview

FlowX.AI 5.9.1 is a maintenance release for the 5.9.x LTS line. It can be deployed as a direct upgrade from 5.9.0 with no breaking changes.

<Card title="Upgrade Path" icon="route">
  **5.9.0 → 5.9.1**: Direct upgrade with no breaking changes.

  Self-hosted customers still on the 5.1.x LTS upgrade directly to the 5.9.x line — see [Migrating from 5.1 LTS](/5.9/migrating-from-5.1-lts/overview).
</Card>

## Component versions

### Core components

| Component                  | 5.9.1    | 5.9.0    | 5.8.0    | 5.1.9 (LTS) |
| -------------------------- | -------- | -------- | -------- | ----------- |
| **process-engine**         | 10.147.1 | 10.135.0 | 10.106.0 | 9.75.3      |
| **admin**                  | 10.130.0 | 10.116.0 | 10.93.0  | 9.75.3      |
| **designer**               | 10.250.0 | 10.230.2 | 10.181.0 | 9.164.4     |
| **cms-core**               | 10.94.0  | 10.86.0  | 10.67.0  | 9.46.2      |
| **scheduler-core**         | 10.78.0  | 10.70.0  | 10.53.0  | 9.35.2      |
| **events-gateway**         | 10.81.0  | 10.72.0  | 10.55.0  | 9.36.2      |
| **notification-plugin**    | 10.92.0  | 10.83.0  | 10.64.0  | 9.39.2      |
| **document-plugin**        | 10.104.0 | 10.94.0  | 10.75.0  | 9.44.2      |
| **task-management-plugin** | 10.93.0  | 10.84.0  | 10.66.0  | 9.43.2      |
| **data-search**            | 10.76.0  | 10.69.0  | 10.52.0  | 9.32.2      |
| **audit-core**             | 10.86.0  | 10.79.0  | 10.63.0  | 9.40.2      |
| **advancing-controller**   | 10.81.0  | 10.73.0  | 10.55.0  | 9.35.2      |
| **integration-designer**   | 10.177.0 | 10.162.0 | 10.128.0 | 9.59.3      |
| **application-manager**    | 10.136.0 | 10.123.0 | 10.97.0  | 9.82.2      |
| **runtime-manager**        | 10.136.0 | 10.123.0 | 10.97.0  | 9.82.2      |
| **data-sync**              | 10.89.0  | 10.81.0  | 10.58.0  | 9.33.2      |
| **authorization-system**   | 10.103.0 | 10.96.1  | 10.77.0  | 9.43.2      |
| **nosql-db-runner**        | 10.84.0  | 10.75.0  | 10.56.0  | 9.31.2      |
| **email-gateway**          | 10.84.0  | 10.74.0  | 10.56.0  | -           |
| **organization-manager**   | 10.80.0  | 10.71.0  | 10.53.0  | -           |
| **webhook-gateway**        | 10.52.0  | 10.44.0  | 10.25.0  | -           |
| **file-gateway**           | 10.16.0  | 10.8.0   | -        | -           |
| **license**                | 10.70.0  | 10.63.0  | 10.46.0  | -           |

### Embedded components

* **SpiceDB** — see the [5.9.0 deployment guidelines](../v5.9.0-june-2026/deployment-guidelines-v5.9) for details.
* **Qdrant** (vector database) — bundled in the AI Platform Helm chart; its version is managed by the chart and not pinned here. See the [Qdrant setup guide](/5.9/setup-guides/qdrant) for deployment and configuration.

### Renderers

| Component                          | 5.9.1    | 5.9.0    | 5.8.0    | 5.1.9 (LTS) |
| ---------------------------------- | -------- | -------- | -------- | ----------- |
| **@flowx/angular-sdk**             | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/angular-theme**           | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/angular-ui-toolkit**      | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/react-sdk**               | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/react-theme**             | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/react-ui-toolkit**        | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/react-native-sdk**        | 10.255.1 | 10.230.2 | -        | -           |
| **@flowx/react-native-theme**      | 10.255.1 | 10.230.2 | -        | -           |
| **@flowx/react-native-ui-toolkit** | 10.255.1 | 10.230.2 | -        | -           |
| **@flowx/core-sdk**                | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **@flowx/core-theme**              | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.4     |
| **react-saas**                     | 10.250.0 | 10.230.2 | -        | -           |
| **iOS renderer**                   | 10.5.0   | 10.4.1   | 10.3.0   | 9.0.20      |
| **Android renderer**               | 10.5.4   | 10.5.0   | 10.3.0   | 9.0.24      |

### AI components

FlowX.AI groups AI services into four tiers by deployment role. **AI Base** components are the foundation; **AI Runtime** and **AI Dev Time** components both require Base to be installed first; **AI Extensions** are optional add-ons layered on top.

#### AI Base components

Foundation services. Install these before any Runtime or Dev Time component.

| Component                                | 5.9.1   | 5.9.0  | 5.8.0  | 5.1.9 (LTS) |
| ---------------------------------------- | ------- | ------ | ------ | ----------- |
| **ai-platform-knowledgebase-indexer-v2** | 10.8.0  | 10.7.0 | 10.7.0 | -           |
| **ai-platform-knowledgebase-rag**        | 10.8.0  | 10.7.0 | 10.7.0 | -           |
| **ai-platform-embedder**                 | 10.8.0  | 10.7.0 | 10.7.0 | -           |
| **doc-parser**                           | 10.10.0 | 10.9.0 | 10.7.0 | -           |

#### AI Runtime components

Requires AI Base. Services that execute AI workloads at runtime.

| Component                     | 5.9.1  | 5.9.0  | 5.8.0  | 5.1.9 (LTS) |
| ----------------------------- | ------ | ------ | ------ | ----------- |
| **ai-platform-agent-builder** | 10.8.0 | 10.7.0 | 10.7.0 | 9.4.2       |
| **data-privacy**              | 10.2.1 | 10.1.0 | 10.1.0 | -           |
| **doc-converter**             | 10.2.3 | 10.2.3 | 10.2.3 | -           |
| **evals-judge**               | 10.2.0 | 10.1.1 | -      | -           |
| **speech-to-text**            | 10.3.5 | 10.3.4 | -      | -           |
| **web-crawler**               | 10.3.6 | 10.3.5 | 10.3.5 | -           |

#### AI Dev Time components

Requires AI Base. Services used at design time inside the Designer.

| Component                     | 5.9.1   | 5.9.0  | 5.8.0  | 5.1.9 (LTS) |
| ----------------------------- | ------- | ------ | ------ | ----------- |
| **ai-gateway**                | 10.17.0 | 10.7.0 | -      | -           |
| **ai-platform-ai-analyst**    | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2       |
| **ai-platform-ai-assistant**  | 10.8.0  | 10.7.0 | 10.7.0 | -           |
| **ai-platform-ai-designer**   | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2       |
| **ai-platform-ai-developer**  | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2       |
| **ai-platform-planner**       | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2       |
| **ai-platform-kb-enrichment** | 10.8.0  | -      | -      | -           |
| **flowx-docs**                | 5.9.1   | 5.9.0  | -      | -           |

#### AI Extensions

Optional add-ons layered on the AI Platform.

| Component          | 5.9.1  | 5.9.0  | 5.8.0  | 5.1.9 (LTS) |
| ------------------ | ------ | ------ | ------ | ----------- |
| **modpod**         | 10.0.7 | 10.0.7 | 10.0.7 | -           |
| **ai-observatory** | 10.7.2 | 10.3.2 | -      | -           |

<Note>
  For the plugins matrix, refer to the [5.9.0 deployment guidelines](../v5.9.0-june-2026/deployment-guidelines-v5.9).
</Note>

## Kafka topics

5.9.1 adds two Kafka topics. Both are **auto-provisioned by the Helm chart** — no manual creation is required for standard deployments. The names and env vars are listed here for environments that provision topics or ACLs manually.

| Topic                                                 | Producer             | Consumer             | Purpose                                                          |
| ----------------------------------------------------- | -------------------- | -------------------- | ---------------------------------------------------------------- |
| `ai.flowx.config.params.events.v1`                    | application-manager  | process-engine       | Runtime config-param change events; invalidates the build cache  |
| `ai.flowx.core.notify.terminated.runtime-instance.v1` | process-engine       | integration-designer | Notifies that a runtime instance has been terminated             |
| `ai.flowx.core.trigger.resource.cache-evict.v1`       | admin                | process-engine       | Resource cache eviction triggered when a process version changes |
| `ai.flowx.evals.suggestions.job.request.v1`           | integration-designer | AI Platform          | Evaluation improvement-suggestion job requests                   |
| `ai.flowx.evals.suggestions.job.response.v1`          | AI Platform          | integration-designer | Evaluation improvement-suggestion job responses                  |

Topic env vars and consumer groups:

| Topic                                                 | Producer var (OUT)                                | Consumer var (IN)                                 | Consumer group                                           |
| ----------------------------------------------------- | ------------------------------------------------- | ------------------------------------------------- | -------------------------------------------------------- |
| `ai.flowx.config.params.events.v1`                    | `KAFKA_TOPIC_CONFIGPARAMS_EVENTS_OUT`             | `KAFKA_TOPIC_CONFIGPARAMS_EVENTS_IN`              | `config-params`                                          |
| `ai.flowx.core.notify.terminated.runtime-instance.v1` | `KAFKA_TOPIC_RUNTIMEINSTANCE_TERMINATED_OUT`      | `KAFKA_TOPIC_RUNTIMEINSTANCE_TERMINATED_IN`       | `integration-designer-runtime-instance-terminated-group` |
| `ai.flowx.core.trigger.resource.cache-evict.v1`       | `KAFKA_TOPIC_RESOURCE_CACHEEVICT`                 | `KAFKA_TOPIC_RESOURCE_CACHEEVICT_IN`              | `resource-cache-evict`                                   |
| `ai.flowx.evals.suggestions.job.request.v1`           | `KAFKA_TOPIC_AI_EVALSSUGGESTIONS_JOB_REQUEST_OUT` | — (consumed by AI Platform)                       | —                                                        |
| `ai.flowx.evals.suggestions.job.response.v1`          | — (produced by AI Platform)                       | `KAFKA_TOPIC_AI_EVALSSUGGESTIONS_JOB_RESPONSE_IN` | `integration-designer-evals-suggestions-response-group`  |

For the config-param cache-invalidation behavior, see [Engine setup → Topics related to runtime config params](/5.9/setup-guides/flowx-engine-setup-guide/engine-setup#topics-related-to-runtime-config-params). For the full multi-release topic matrix, see the [5.9.0 deployment guidelines](../v5.9.0-june-2026/deployment-guidelines-v5.9#kafka-topics).

## Deployment notes

### Standard deployment

This maintenance release follows standard FlowX.AI deployment procedures:

1. Update container images to the 5.9.1 versions listed in the table above.
2. Deploy services using your standard deployment process.
3. Verify deployment via **FlowX.AI Designer → Platform Status**.

### Configuration changes

<Info>
  Confirm any required configuration changes against the setup guides before upgrading.
</Info>

## Third-party supported component versions

Within each version line listed below, versions that have reached upstream end of life are not supported, even though their major/minor is listed.

| FlowX.AI Version | 3rd Party Dependency              | Supported Versions |
| ---------------- | --------------------------------- | ------------------ |
| 5.9.x            | Keycloak                          | 26                 |
| 5.9.x            | Kafka                             | 3.9, 4.0, 4.1, 4.2 |
| 5.9.x            | PostgreSQL                        | 16, 17, 18         |
| 5.9.x            | Oracle Database                   | 21c, 23ai          |
| 5.9.x            | MongoDB                           | 7, 8               |
| 5.9.x            | Redis                             | 7, 8               |
| 5.9.x            | Elasticsearch                     | 8, 9               |
| 5.9.x            | Elasticsearch Sink Connector (\*) | 15                 |
| 5.9.x            | Angular (Web SDK)                 | 20.3               |
| 5.9.x            | React (Web SDK)                   | 19                 |

(\*) Required only if using indexing via Kafka. Multiple sink connector implementations also work, as long as they are compatible with both the deployed Kafka and Elasticsearch version.

<Info>
  The table lists version lines, not individual versions. A version is supported for as long as its vendor still supports it, so check the version you plan to deploy against that vendor's lifecycle page before committing to it. When a version reaches upstream end of life it is no longer supported; upgrade that component to keep your deployment on a supported configuration. Versions can also be added during the family's lifetime as FlowX validates them.
</Info>

<Info>
  For previous FlowX.AI releases, please refer to the [Release Notes overview](../../overview).
</Info>


## Related topics

- [AI Platform setup](/5.9/setup-guides/ai-platform-setup.md)
- [Deployment guidelines v5.6.0](/release-notes/v5.x/v5.6.0-march-2026/deployment-guidelines-v5.6.md)
- [Deployment guidelines v5.3.0](/release-notes/v5.x/v5.3.0-december-2025/deployment-guidelines-v5.3.md)
- [Deployment guidelines v5.4.0](/release-notes/v5.x/v5.4.0-january-2026/deployment-guidelines-v5.4.md)
- [Deployment guidelines v5.5.0](/release-notes/v5.x/v5.5.0-february-2026/deployment-guidelines-v5.5.md)