> ## 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.3

> Component versions, configuration, and deployment notes for FlowX.AI 5.9.3 (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.3 is a maintenance release for the 5.9.x LTS line. It can be deployed as a direct upgrade from 5.9.2 with no breaking changes.

<Card title="Upgrade Path" icon="route">
  **5.9.2 → 5.9.3**: 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>

<Note>
  **Upgrading from 5.9.0 or 5.9.1 directly?** Review the [5.9.2 deployment guidelines](../v5.9.2-july-2026/deployment-guidelines-v5.9.2) first — they include required steps for the organization-ID migration fix and manually marked Liquibase changesets that also apply when you skip 5.9.2.
</Note>

## Component versions

### Core components

| Component                  | 5.9.3    | 5.9.2    | 5.9.0    | 5.8.0    | 5.1.11 (LTS) |
| -------------------------- | -------- | -------- | -------- | -------- | ------------ |
| **process-engine**         | 10.165.0 | 10.162.1 | 10.135.0 | 10.106.0 | 9.76.3       |
| **admin**                  | 10.144.0 | 10.141.1 | 10.116.0 | 10.93.0  | 9.76.3       |
| **designer**               | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **cms-core**               | 10.105.0 | 10.102.3 | 10.86.0  | 10.67.0  | 9.47.3       |
| **scheduler-core**         | 10.87.0  | 10.85.1  | 10.70.0  | 10.53.0  | 9.36.3       |
| **events-gateway**         | 10.93.0  | 10.90.1  | 10.72.0  | 10.55.0  | 9.37.3       |
| **notification-plugin**    | 10.103.0 | 10.100.2 | 10.83.0  | 10.64.0  | 9.40.3       |
| **document-plugin**        | 10.116.0 | 10.113.2 | 10.94.0  | 10.75.0  | 9.45.3       |
| **task-management-plugin** | 10.105.0 | 10.102.1 | 10.84.0  | 10.66.0  | 9.44.4       |
| **data-search**            | 10.85.0  | 10.83.1  | 10.69.0  | 10.52.0  | 9.33.3       |
| **audit-core**             | 10.95.0  | 10.93.1  | 10.79.0  | 10.63.0  | 9.41.3       |
| **advancing-controller**   | 10.91.0  | 10.89.1  | 10.73.0  | 10.55.0  | 9.36.3       |
| **integration-designer**   | 10.192.0 | 10.189.2 | 10.162.0 | 10.128.0 | 9.60.3       |
| **application-manager**    | 10.151.1 | 10.148.3 | 10.123.0 | 10.97.0  | 9.83.5       |
| **runtime-manager**        | 10.151.1 | 10.148.3 | 10.123.0 | 10.97.0  | 9.83.5       |
| **data-sync**              | 10.100.0 | 10.98.0  | 10.81.0  | 10.58.0  | 9.34.2       |
| **authorization-system**   | 10.115.0 | 10.112.1 | 10.96.1  | 10.77.0  | 9.44.4       |
| **nosql-db-runner**        | 10.94.0  | 10.92.1  | 10.75.0  | 10.56.0  | 9.32.3       |
| **email-gateway**          | 10.93.0  | 10.91.1  | 10.74.0  | 10.56.0  | -            |
| **organization-manager**   | 10.90.0  | 10.88.1  | 10.71.0  | 10.53.0  | -            |
| **webhook-gateway**        | 10.62.0  | 10.60.1  | 10.44.0  | 10.25.0  | -            |
| **file-gateway**           | 10.25.0  | 10.23.1  | 10.8.0   | -        | -            |
| **license**                | 10.80.0  | 10.78.1  | 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.3    | 5.9.2    | 5.9.0    | 5.8.0    | 5.1.11 (LTS) |
| ---------------------------------- | -------- | -------- | -------- | -------- | ------------ |
| **@flowx/angular-sdk**             | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/angular-theme**           | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/angular-ui-toolkit**      | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/react-sdk**               | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/react-theme**             | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/react-ui-toolkit**        | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/react-native-sdk**        | 10.266.0 | 10.262.0 | 10.230.2 | -        | -            |
| **@flowx/react-native-theme**      | 10.266.0 | 10.262.0 | 10.230.2 | -        | -            |
| **@flowx/react-native-ui-toolkit** | 10.266.0 | 10.262.0 | 10.230.2 | -        | -            |
| **@flowx/core-sdk**                | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **@flowx/core-theme**              | 10.265.6 | 10.260.7 | 10.230.2 | 10.181.0 | 9.164.15     |
| **react-saas**                     | 10.265.6 | 10.260.7 | 10.230.2 | -        | -            |
| **iOS renderer**                   | 10.5.11  | 10.5.6   | 10.4.1   | 10.3.0   | 9.0.27       |
| **Android renderer**               | 10.6.6   | 10.5.6   | 10.5.0   | 10.3.0   | 9.0.37       |

### 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.

<Info>
  **AI component versioning is unified in 5.9.2.** All AI Platform services now ship under a single AI Platform version (**10.9.0**), including services that previously carried their own version lines (`doc-parser`, `doc-converter`, `data-privacy`, `speech-to-text`, `web-crawler`, `evals-judge`). Their 5.9.2 version numbers are therefore not comparable with earlier columns — for example, `doc-parser` moves from 10.10.1 to 10.9.0 without losing anything. Component rows below use the plain service names introduced in 5.9.2 (the `ai-platform-` prefix is dropped — see [AI Platform service naming](#ai-platform-service-naming)); earlier columns show the same component under its previous name.
</Info>

#### AI Base components

| Component                    | 5.9.3  | 5.9.2  | 5.9.0  | 5.8.0  | 5.1.11 (LTS) |
| ---------------------------- | ------ | ------ | ------ | ------ | ------------ |
| **knowledgebase-indexer-v2** | 10.9.1 | 10.9.0 | 10.7.0 | 10.7.0 | -            |
| **knowledgebase-rag**        | 10.9.1 | 10.9.0 | 10.7.0 | 10.7.0 | -            |
| **embedder**                 | 10.9.1 | 10.9.0 | 10.7.0 | 10.7.0 | -            |
| **doc-parser**               | 10.9.1 | 10.9.0 | 10.9.0 | 10.7.0 | -            |

#### AI Runtime components

| Component          | 5.9.3  | 5.9.2  | 5.9.0  | 5.8.0  | 5.1.11 (LTS) |
| ------------------ | ------ | ------ | ------ | ------ | ------------ |
| **agent-builder**  | 10.9.1 | 10.9.0 | 10.7.0 | 10.7.0 | 9.4.2        |
| **data-privacy**   | 10.9.1 | 10.9.0 | 10.1.0 | 10.1.0 | -            |
| **doc-converter**  | 10.9.1 | 10.9.0 | 10.2.3 | 10.2.3 | -            |
| **evals-judge**    | 10.9.1 | 10.9.0 | 10.1.1 | -      | -            |
| **speech-to-text** | 10.9.1 | 10.9.0 | 10.3.4 | -      | -            |
| **web-crawler**    | 10.9.1 | 10.9.0 | 10.3.5 | 10.3.5 | -            |

#### AI Dev Time components

| Component         | 5.9.3   | 5.9.2   | 5.9.0  | 5.8.0  | 5.1.11 (LTS) |
| ----------------- | ------- | ------- | ------ | ------ | ------------ |
| **ai-gateway**    | 10.27.0 | 10.25.0 | 10.7.0 | -      | -            |
| **ai-analyst**    | 10.9.1  | 10.9.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **ai-architect**  | 10.9.1  | 10.9.0  | -      | -      | -            |
| **ai-assistant**  | 10.9.1  | 10.9.0  | 10.7.0 | 10.7.0 | -            |
| **ai-designer**   | 10.9.1  | 10.9.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **ai-developer**  | 10.9.1  | 10.9.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **planner**       | 10.9.1  | 10.9.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **kb-enrichment** | 10.9.1  | 10.9.0  | -      | -      | -            |
| **flowx-docs**    | 5.9.3   | 5.9.2   | 5.9.0  | -      | -            |

{/* 5.1.10 (LTS) AI column: the 5.1.x LTS ships the OLD AI Platform service set (di-platform 9.3.1, standalone ai-assistant 9.2.9, connected-graph, knowledge-graph, agents, conversations, models, tenants, binaries — all 9.4.2; see deployment-guidelines-v5.1.10). Only identically-named services carry a 5.1.10 value; 5.1's standalone `ai-assistant` is a different component from ai-platform-ai-assistant, hence "-". */}

#### AI Extensions

| Component          | 5.9.3  | 5.9.2  | 5.9.0  | 5.8.0  | 5.1.11 (LTS) |
| ------------------ | ------ | ------ | ------ | ------ | ------------ |
| **modpod**         | 10.0.7 | 10.0.7 | 10.0.7 | 10.0.7 | -            |
| **ai-observatory** | 10.7.2 | 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

<Info>
  5.9.3 introduces no new Kafka topics over 5.9.2. 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).
</Info>

## Deployment notes

### Standard deployment

This maintenance release follows standard FlowX.AI deployment procedures:

1. Update container images to the 5.9.3 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

#### Events Gateway — Redis connection pool for blocking mode

The Events Gateway's blocking read path is rebuilt on a dedicated Redis connection pool, fixing a connection leak that could previously require periodic Events Gateway restarts under sustained load. The new settings ship with working defaults — no action is required on upgrade.

| Environment variable                | Default | Change in 5.9.3                                                        |
| ----------------------------------- | ------- | ---------------------------------------------------------------------- |
| `EVENTS_REDIS_POOL_ENABLED`         | `true`  | New — dedicated connection pool for blocking reads                     |
| `EVENTS_REDIS_POOL_MAXTOTAL`        | `50`    | New — maximum pooled connections                                       |
| `EVENTS_REDIS_POOL_MAXIDLE`         | `50`    | New — maximum idle pooled connections                                  |
| `EVENTS_REDIS_POOL_MINIDLE`         | `5`     | New — minimum idle pooled connections                                  |
| `EVENTS_REDIS_POOL_MAXWAITMILLIS`   | `5000`  | New — wait time for a pooled connection before failing                 |
| `EVENTS_REDIS_SSE_BUFFERSIZE`       | `256`   | New — per-subscriber SSE backpressure buffer                           |
| `EVENTS_REDIS_BLOCKDURATIONSECONDS` | `1`     | Default lowered from `5` — shortens the blocking-read reissue interval |

If you previously set `EVENTS_REDIS_BLOCKDURATIONSECONDS` explicitly, review whether the new default suits your setup. See the [Events Gateway setup guide](/5.9/setup-guides/events-gateway-setup#events) for the full configuration reference.

#### Integration Designer — workflow topic partitions

`FLOWX_WORKFLOW_TOPICPARTITIONS` (default `1`) sets the number of partitions for auto-created workflow Kafka topics (used with `FLOWX_WORKFLOW_CREATETOPICS`). Existing topics are not modified; the setting applies to newly created topics only. {/* Internal: PLAT-1900, b51f2120f4, first tag integration-designer-v10.189.4 > 5.9.2 pin 10.189.2. TODO fx-confirm @5.9.3 (header TODO #3). "Existing topics are not modified" — NewTopic creation only per the diff; AdminClient does not alter partition counts of existing topics. */}

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

## Third-party supported component versions

{/* Matrix content lives in /snippets/third-party-supported-59x.mdx — ONE source for every 5.9.x page. Edit the snippet, not this page. Values owned by eng/release (Mircea). */}

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

- [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)
- [Deployment guidelines v5.2.0](/release-notes/v5.x/v5.2.0-november-2025/deployment-guidelines-v5.2.md)
- [Deployment guidelines v5.6.0](/release-notes/v5.x/v5.6.0-march-2026/deployment-guidelines-v5.6.md)