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

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

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

<Warning>
  **Organization-ID migration fix (application-manager).** 5.9.2 corrects the runtime-application organization-ID migration. If you worked around the original migration on 5.9.0 or 5.9.1 by manually marking it as executed, **remove that record after upgrading to 5.9.2** so the corrected migration runs and converts your data. If you did not apply that workaround, no action is needed.
</Warning>

<Warning>
  **Manually marked Liquibase changesets.** If any Liquibase changesets were manually marked as executed (MARK\_RAN) to work around failures during earlier 5.9.x upgrade attempts, those records must be removed after upgrading to 5.9.2 so the corrected changesets can run. Contact FlowX support for the exact list of affected changesets before removing anything. If you did not mark any changesets manually, no action is needed.
</Warning>

## Component versions

### Core components

| Component                  | 5.9.2    | 5.9.1    | 5.9.0    | 5.8.0    | 5.1.10 (LTS) |
| -------------------------- | -------- | -------- | -------- | -------- | ------------ |
| **process-engine**         | 10.162.1 | 10.147.1 | 10.135.0 | 10.106.0 | 9.75.7       |
| **admin**                  | 10.141.1 | 10.130.0 | 10.116.0 | 10.93.0  | 9.75.7       |
| **designer**               | 10.260.7 | 10.250.0 | 10.230.2 | 10.181.0 | 9.164.10     |
| **cms-core**               | 10.102.3 | 10.94.0  | 10.86.0  | 10.67.0  | 9.46.3       |
| **scheduler-core**         | 10.85.1  | 10.78.0  | 10.70.0  | 10.53.0  | 9.35.3       |
| **events-gateway**         | 10.90.1  | 10.81.0  | 10.72.0  | 10.55.0  | 9.36.4       |
| **notification-plugin**    | 10.100.2 | 10.92.0  | 10.83.0  | 10.64.0  | 9.39.3       |
| **document-plugin**        | 10.113.2 | 10.104.0 | 10.94.0  | 10.75.0  | 9.44.3       |
| **task-management-plugin** | 10.102.1 | 10.93.0  | 10.84.0  | 10.66.0  | 9.43.3       |
| **data-search**            | 10.83.1  | 10.76.0  | 10.69.0  | 10.52.0  | 9.32.3       |
| **audit-core**             | 10.93.1  | 10.86.0  | 10.79.0  | 10.63.0  | 9.40.3       |
| **advancing-controller**   | 10.89.1  | 10.81.0  | 10.73.0  | 10.55.0  | 9.35.3       |
| **integration-designer**   | 10.189.2 | 10.177.0 | 10.162.0 | 10.128.0 | 9.59.4       |
| **application-manager**    | 10.148.3 | 10.136.0 | 10.123.0 | 10.97.0  | 9.82.5       |
| **runtime-manager**        | 10.148.3 | 10.136.0 | 10.123.0 | 10.97.0  | 9.82.5       |
| **data-sync**              | 10.98.0  | 10.89.0  | 10.81.0  | 10.58.0  | 9.33.4       |
| **authorization-system**   | 10.112.1 | 10.103.0 | 10.96.1  | 10.77.0  | 9.43.5       |
| **nosql-db-runner**        | 10.92.1  | 10.84.0  | 10.75.0  | 10.56.0  | 9.31.3       |
| **email-gateway**          | 10.91.1  | 10.84.0  | 10.74.0  | 10.56.0  | -            |
| **organization-manager**   | 10.88.1  | 10.80.0  | 10.71.0  | 10.53.0  | -            |
| **webhook-gateway**        | 10.60.1  | 10.52.0  | 10.44.0  | 10.25.0  | -            |
| **file-gateway**           | 10.23.1  | 10.16.0  | 10.8.0   | -        | -            |
| **license**                | 10.78.1  | 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.2    | 5.9.1    | 5.9.0    | 5.8.0    | 5.1.10 (LTS) |
| ---------------------------------- | -------- | -------- | -------- | -------- | ------------ |
| **@flowx/angular-sdk**             | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/angular-theme**           | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/angular-ui-toolkit**      | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/react-sdk**               | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/react-theme**             | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/react-ui-toolkit**        | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/react-native-sdk**        | 10.262.0 | 10.255.1 | 10.230.2 | -        | -            |
| **@flowx/react-native-theme**      | 10.262.0 | 10.255.1 | 10.230.2 | -        | -            |
| **@flowx/react-native-ui-toolkit** | 10.262.0 | 10.255.1 | 10.230.2 | -        | -            |
| **@flowx/core-sdk**                | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **@flowx/core-theme**              | 10.260.7 | 10.250.2 | 10.230.2 | 10.181.0 | 9.164.10     |
| **react-saas**                     | 10.260.7 | 10.250.0 | 10.230.2 | -        | -            |
| **iOS renderer**                   | 10.5.6   | 10.5.0   | 10.4.1   | 10.3.0   | 9.0.25       |
| **Android renderer**               | 10.5.6   | 10.5.4   | 10.5.0   | 10.3.0   | 9.0.31       |

### 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.2  | 5.9.1   | 5.9.0  | 5.8.0  | 5.1.10 (LTS) |
| ---------------------------- | ------ | ------- | ------ | ------ | ------------ |
| **knowledgebase-indexer-v2** | 10.9.0 | 10.8.0  | 10.7.0 | 10.7.0 | -            |
| **knowledgebase-rag**        | 10.9.0 | 10.8.0  | 10.7.0 | 10.7.0 | -            |
| **embedder**                 | 10.9.0 | 10.8.0  | 10.7.0 | 10.7.0 | -            |
| **doc-parser**               | 10.9.0 | 10.10.0 | 10.9.0 | 10.7.0 | -            |

#### AI Runtime components

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

#### AI Dev Time components

| Component         | 5.9.2   | 5.9.1   | 5.9.0  | 5.8.0  | 5.1.10 (LTS) |
| ----------------- | ------- | ------- | ------ | ------ | ------------ |
| **ai-gateway**    | 10.25.0 | 10.17.0 | 10.7.0 | -      | -            |
| **ai-analyst**    | 10.9.0  | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **ai-architect**  | 10.9.0  | -       | -      | -      | -            |
| **ai-assistant**  | 10.9.0  | 10.8.0  | 10.7.0 | 10.7.0 | -            |
| **ai-designer**   | 10.9.0  | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **ai-developer**  | 10.9.0  | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **planner**       | 10.9.0  | 10.8.0  | 10.7.0 | 10.7.0 | 9.4.2        |
| **kb-enrichment** | 10.9.0  | 10.8.0  | -      | -      | -            |
| **flowx-docs**    | 5.9.2   | 5.9.1   | 5.9.0  | -      | -            |

#### AI Extensions

| Component          | 5.9.2  | 5.9.1  | 5.9.0  | 5.8.0  | 5.1.10 (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.2 introduces no new Kafka topics over 5.9.1. For the topics added in 5.9.1, see the [5.9.1 deployment guidelines](../v5.9.1-june-2026/deployment-guidelines-v5.9.1#kafka-topics); 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.2 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

* **Kafka reconnect backoff:** platform services now default to a gentler broker-reconnect backoff — `SPRING_KAFKA_PRODUCER_PROPERTIES_RECONNECT_BACKOFF_MS` `1000` / `SPRING_KAFKA_PRODUCER_PROPERTIES_RECONNECT_BACKOFF_MAX_MS` `10000` (and the consumer equivalents) — and repetitive Kafka NetworkClient connection errors log at a quieter level, tunable via `LOGGING_LEVEL_KAFKA_NETWORK_CLIENT` (default `ERROR`). No action needed unless you previously tuned these.&#x20;
* **Resource-server security type:** the default for `idp.resourceServer.securityType` on the AI services changes to `jwt`. If you previously set the security type to `jwt` explicitly as a workaround, that override is no longer needed and can be removed.&#x20;

#### Data partitioning and archiving

5.9.2 adds configuration for the archiving lifecycle on the process-engine and Integration Designer. All new settings default to off, so no action is required on upgrade.&#x20;

* **Stuck-instance termination:** an optional sweep (`FLOWX_DATA_PARTITIONING_ARCHIVING_STUCKTERMINATE_ENABLED`, default `false`) terminates instances that would otherwise block archiving. Enable it, plus its cron and batch-size, if archiving stalls on unfinished data.
* **Legacy backfill:** one-shot backfills of `partition_id` (`FLOWX_DATA_PARTITIONING_BACKFILL_ENABLED`) and `organization_id` (`FLOWX_DATA_PARTITIONING_ORGIDBACKFILL_ENABLED`), both default `false`, populate legacy rows when you first turn partitioning on. The organization-ID backfill is optional on self-hosted and can remain `false`.

<Warning>
  **Partitions that still contain unfinished instances are not archived.** Starting with 5.9.2, the archiving job detaches a partition only when every process instance in it has reached a finished state (`FINISHED`, `FINISHED_WITH_ERROR`, `FAILED`, `EXPIRED`, `ABORTED`, `DISMISSED`, or `TERMINATED`). A single instance still in `CREATED`, `STARTED`, or `ON_HOLD` blocks the entire partition; it is retried on the next archiving run. The same rule applies to workflow instances on the Integration Designer, where a `STARTED` workflow instance blocks its partition. If partitions accumulate unarchived, terminate the blocking instances — set process expiry, or turn on the stuck-instance termination sweep above.
</Warning>

For the full property tables and defaults, see [Partitioning & archiving](/5.9/setup-guides/flowx-engine-setup-guide/process-instance-data-archiving#configuring-partitioning-and-archiving) (process-engine) and [Integration Designer setup → Workflow partitioning](/5.9/setup-guides/integration-designer-setup#workflow-partitioning-configuration).

#### AI Platform service naming

AI Platform services are now deployed under their plain names — the `ai-platform-` prefix is dropped from pod, service, and image names (for example, `ai-platform-agent-builder` becomes `agent-builder`). If you have monitoring dashboards, alerts, or log queries that match the prefixed names, update them as part of this upgrade. The bundled Qdrant subchart is renamed the same way, so any explicit references to its service host must be updated too.

<Warning>
  Core platform services resolve AI Platform components by these new names. Upgrade the AI Platform chart and the core platform services to 5.9.2 together — running a 5.9.1 AI Platform chart against 5.9.2 core services (or the reverse) breaks AI features.
</Warning>

<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

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