Skip to main content
Update environment variable configurations for all existing FlowX.AI services to support version 5.0.0 compatibility.

Audit core

Elasticsearch configuration migrates from SPRING_ELASTICSEARCH_* to FLOWX_ELASTICSEARCH_* namespace with enhanced index management.

Variables to remove & replace

New variables to add

Since FlowX.AI 4.7.6, the Audit service rewrites its Elasticsearch index lifecycle management (ILM) policy, audit-logs_policy by default, every time it starts. The policy has a single hot phase that rolls over after FLOWX_ELASTICSEARCH_INDEXROLLOVERDAYS days, and no delete phase. Any phase you added directly in Elasticsearch, such as a delete phase, is removed on the next startup, so old audit indices are never deleted and audit storage keeps growing.If you’re upgrading from 4.7.5 or earlier, the rollover period also changes from a fixed 1 day to a default of 30 days. To keep daily rollover, set FLOWX_ELASTICSEARCH_INDEXROLLOVERDAYS=1.
Simple migration with containerization support and namespace alignment.

Variables to update

Variables to replace

Kafka Configuration

Consumer group naming standardized to kebab-case across all FlowX.AI services with new messaging features for enhanced functionality.
Do not modify default consumer group names. We strongly recommend against changing the default consumer group names as this operation can lead to misconfigurations. The application is designed to work and scale with the consumer groups as they are defined by default.

Consumer group naming changes

Admin (3 groups):Application Manager (15 groups):CMS Core (1 group):Document Plugin (1 group):Integration Designer (3 groups):Notification Plugin (1 group):Process Engine (11 groups):

Application Manager specific features

New environment variables

New Kafka features

Resource Update Propagation

Consumer Group: app-resource-update-propagation-group
Threads: 3
Topic: ai.flowx.{env}.application-version.resource.update.propagation.v1

Build Runtime Data

Consumer Group: build-runtime-data-group
Threads: 2
Topic: ai.flowx.{env}.build.runtime-data.v1

Business Rule Sync

Topic: ai.flowx.{env}.application-version.sync.business-rule.in.v1
Purpose: Business rule synchronization

Process Sync (Restructured)

Topic: ai.flowx.{env}.application-version.sync.process.in.v1
Purpose: Enhanced process synchronization

Reusable Templates sync

Topic: ai.flowx.{env}.application-version.sync.reusable-template.in.v1
Purpose: Reusable template synchronization

Kafka environment variables (optional overrides)

Automatic Configuration: Most deployments can rely on the built-in naming patterns without explicit environment variable overrides.

Integration Designer

Storage configuration

Added support for S3 storage for files in Integration Designer.

Redis

Added caching when running a workflow.

Java runtime configuration

FlowX.AI containers and services must rely exclusively on Java-standard environment variables for runtime tuning.
Environment-specific memory configurations must now be defined using JDK_JAVA_OPTIONS. Avoid relying on JAVA_OPTS, JAVA_TOOL_OPTIONS or legacy Docker-level overrides — these are no longer processed explicitly.

Config profiles

Config profiles are deprecated since 4.7.6 version.
Remove legacy CONFIG_PROFILE usage. Delete any CONFIG_PROFILE environment variable definitions from deployments. This variable is no longer referenced by FlowX.AI services.
Last modified on October 29, 2026