> ## 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.255.1 | 10.255.1 | 10.230.2 | -        | -            |
| **@flowx/react-native-theme**      | 10.255.1 | 10.255.1 | 10.230.2 | -        | -            |
| **@flowx/react-native-ui-toolkit** | 10.255.1 | 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.2   | 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  | -      | -            |

{/* 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.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. {/* Internal: 0aea32339695 on release/5.9.x ⊂ process-engine-v10.162.1 ✓; env names + defaults fx-verified at the 5.9.2 pin (fx config show --service process-engine 10.162.1, 07-10). Follow-ups item #6 from the 07-06 scan. 5.1.x counterpart 4ed75b1040 NOT in 5.1.10 pins — do not backport the note. */}
* **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. {/* Internal: PLAT-1876 = ZD-1321. RESTORED 2026-07-10 after a hold: the flip is now IN the current pins — ai-platform b746b0dd contained in v10.9.0 (pin moved 10.8.3 → 10.9.0 on 07-10) + ai-gateway chart values af053cbc86 in ai-gateway-v10.25.0 (flowx-core-services, not k8s-flowx-base — that's where the hash lives). Was held 07-09 because 10.8.3 predated the commit. Tags are monotonic so this can't fall back out; still confirm at `fx versions 5.9.2`. OTP guidance accordingly: they can drop their explicit override after upgrading. */}

#### 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 recommended component versions

<Info>
  Third-party dependency support is unchanged from 5.9.0 unless noted at tag-cut. See the [5.9.0 deployment guidelines](../v5.9.0-june-2026/deployment-guidelines-v5.9#third-party-recommended-component-versions) for the full matrix (Keycloak, Kafka, PostgreSQL, MongoDB, Redis, Elasticsearch, and SDK framework versions).
</Info>

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