Extension Configuration Reference

Directory where to look for Workflow definition files.

It is relative to src/main directory.

If you set by example workflows, the Workflow definitions must be located in src/main/workflows.

Environment variable: QUARKUS_FLOW_DEFINITIONS_DIR

Prefix used to construct the Identifier#value() when generating io.quarkiverse.flow.Flow and io.serverlessworkflow.impl.WorkflowDefinition beans.

Must be a valid Java package name.

Example:

Generated identifiers are:

If quarkus.flow.definitions.namespace.prefix is not set, the namespace declared inside the workflow definition file is used.

Following the previous example, the generated identifiers would be:

@Identifier("flow.MyWorkflow") and @Identifier("flow:myWorkflow").

Environment variable: QUARKUS_FLOW_DEFINITIONS_NAMESPACE_PREFIX

Whether to enable workflow execution tracing. If not set, it defaults to true in dev and test mode.

Environment variable: QUARKUS_FLOW_TRACING_ENABLED

Connect timeout in milliseconds.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_CONNECT_TIMEOUT

Read timeout in milliseconds.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_READ_TIMEOUT

Maximum size of the HTTP connection pool (number of concurrent connections).

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_CONNECTION_POOL_SIZE

Whether HTTP keep-alive is enabled.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_KEEP_ALIVE_ENABLED

Connection time-to-live in seconds.

After this time, idle connections can be closed and reestablished.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_CONNECTION_TTL

Quarkus REST client name used when the underlying HTTP client is shared.

This name corresponds to the Vert.x HTTP client name and is only used when shared() is true.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAME

Whether this HTTP client is shared with other Quarkus REST clients.

When true, the underlying Vert.x HttpClient can be reused across multiple REST clients based on the name().

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_SHARED

Maximum number of redirects allowed for a request.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_MAX_REDIRECTS

Maximum size of all HTTP headers for HTTP/1.x, in bytes.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_MAX_HEADER_SIZE

Maximum length of the initial HTTP/1.x request line, in bytes.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_MAX_INITIAL_LINE_LENGTH

HTTP User-Agent header to use for requests.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_USER_AGENT

Enables HTTP/2 for this client when set to true.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_HTTP2

Enables ALPN (Application-Layer Protocol Negotiation) for this client when set to true.

ALPN is typically required for HTTP/2 over TLS.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_ALPN

Whether to capture the stack trace of REST client invocations.

This is mainly useful for debugging and error reporting, at the cost of some overhead.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_CAPTURE_STACKTRACE

Logging scope for the underlying REST client.

Supported values (case-insensitive):

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_LOGGING_SCOPE

Maximum number of characters of the request/response body to log.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_LOGGING_BODY_LIMIT

Static HTTP headers to apply to every request by this client.

The value is parsed as a comma-separated list of name=value pairs, for example:

For a named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_STATIC_HEADERS

HTTP proxy host.

When set together with proxy-port(), requests are sent through the given HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxy(host, port).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_PROXY_HOST

HTTP proxy port.

Only used when proxy-host() is also set.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxy(host, port).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_PROXY_PORT

Username for authenticating with the HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxyUser(user).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_PROXY_USER

Password for authenticating with the HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxyPassword(password).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_PROXY_PASSWORD

Hosts that should bypass the HTTP proxy.

The value is a |-separated pattern list, similar to the standard http.nonProxyHosts format:

Named client:

Internally mapped to ClientBuilderImpl.nonProxyHosts(hostsPattern).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NON_PROXY_HOSTS

Proxy connect timeout in milliseconds.

Controls how long the client will wait when establishing a connection to the configured HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxyConnectTimeout(Duration).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_PROXY_CONNECT_TIMEOUT

Whether the client should automatically follow HTTP redirects.

When true, 3xx responses are transparently followed up to max-redirects().

Default client:

Named client:

Internally mapped to ClientBuilderImpl.followRedirects(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_FOLLOW_REDIRECTS

Whether HTTP compression is enabled.

When true, the client advertises support for compressed responses and transparently decompresses them when supported by the server.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.enableCompression(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_ENABLE_COMPRESSION

Maximum HTTP chunk size in bytes.

This controls the underlying Vert.x HTTP parser chunk size. For most users the default is sufficient; only adjust if you need fine-grained control over streaming behaviour.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.maxChunkSize(int).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_MAX_CHUNK_SIZE

Maximum content length (in bytes) for HTTP/2 clear-text upgrade (h2c).

Controls the threshold used when upgrading HTTP/1.1 connections to HTTP/2 without TLS.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.http2UpgradeMaxContentLength(int).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_HTTP2_UPGRADE_MAX_CONTENT_LENGTH

How multiple query parameters with the same name are encoded.

Valid values correspond to org.jboss.resteasy.reactive.common.jaxrs.MultiQueryParamMode: for example COMMA, DUPLICATE, ARRAY.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.multiQueryParamMode(MultiQueryParamMode).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_MULTI_QUERY_PARAM_MODE

Whether to trust all TLS certificates.

Warning: enabling this effectively disables certificate validation and should only be used in development or controlled environments.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.trustAll(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_TRUST_ALL

Whether to verify the remote TLS hostname.

When false, hostname verification is disabled. This is insecure and should only be used in development or with great care in production.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.verifyHost(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_VERIFY_HOST

Name of the custom io.quarkus.credentials.CredentialsProvider bean name to use as a global source for Workflow Secrets. This means that every io.serverlessworkflow.impl.WorkflowDefinition will use the same credential provider.

Environment variable: QUARKUS_FLOW_SECRETS_CREDENTIALS_PROVIDER_NAME

Specific custom io.quarkus.credentials.CredentialsProvider per workflow secret definition. In this case, you can specify one credential provider per io.serverlessworkflow.impl.WorkflowDefinition secret. Use the secret name as a key, e.g.:

Environment variable: QUARKUS_FLOW_SECRETS_CREDENTIALS_PROVIDER_NAMES__CREDENTIALS_PROVIDER_NAMES_

Connect timeout in milliseconds.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__CONNECT_TIMEOUT

Read timeout in milliseconds.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__READ_TIMEOUT

Maximum size of the HTTP connection pool (number of concurrent connections).

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__CONNECTION_POOL_SIZE

Whether HTTP keep-alive is enabled.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__KEEP_ALIVE_ENABLED

Connection time-to-live in seconds.

After this time, idle connections can be closed and reestablished.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__CONNECTION_TTL

Quarkus REST client name used when the underlying HTTP client is shared.

This name corresponds to the Vert.x HTTP client name and is only used when shared() is true.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__NAME

Whether this HTTP client is shared with other Quarkus REST clients.

When true, the underlying Vert.x HttpClient can be reused across multiple REST clients based on the name().

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__SHARED

Maximum number of redirects allowed for a request.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__MAX_REDIRECTS

Maximum size of all HTTP headers for HTTP/1.x, in bytes.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__MAX_HEADER_SIZE

Maximum length of the initial HTTP/1.x request line, in bytes.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__MAX_INITIAL_LINE_LENGTH

HTTP User-Agent header to use for requests.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__USER_AGENT

Enables HTTP/2 for this client when set to true.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__HTTP2

Enables ALPN (Application-Layer Protocol Negotiation) for this client when set to true.

ALPN is typically required for HTTP/2 over TLS.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__ALPN

Whether to capture the stack trace of REST client invocations.

This is mainly useful for debugging and error reporting, at the cost of some overhead.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__CAPTURE_STACKTRACE

Logging scope for the underlying REST client.

Supported values (case-insensitive):

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__LOGGING_SCOPE

Maximum number of characters of the request/response body to log.

Default client:

Named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__LOGGING_BODY_LIMIT

Static HTTP headers to apply to every request by this client.

The value is parsed as a comma-separated list of name=value pairs, for example:

For a named client:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__STATIC_HEADERS

HTTP proxy host.

When set together with proxy-port(), requests are sent through the given HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxy(host, port).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__PROXY_HOST

HTTP proxy port.

Only used when proxy-host() is also set.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxy(host, port).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__PROXY_PORT

Username for authenticating with the HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxyUser(user).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__PROXY_USER

Password for authenticating with the HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxyPassword(password).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__PROXY_PASSWORD

Hosts that should bypass the HTTP proxy.

The value is a |-separated pattern list, similar to the standard http.nonProxyHosts format:

Named client:

Internally mapped to ClientBuilderImpl.nonProxyHosts(hostsPattern).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__NON_PROXY_HOSTS

Proxy connect timeout in milliseconds.

Controls how long the client will wait when establishing a connection to the configured HTTP proxy.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.proxyConnectTimeout(Duration).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__PROXY_CONNECT_TIMEOUT

Whether the client should automatically follow HTTP redirects.

When true, 3xx responses are transparently followed up to max-redirects().

Default client:

Named client:

Internally mapped to ClientBuilderImpl.followRedirects(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__FOLLOW_REDIRECTS

Whether HTTP compression is enabled.

When true, the client advertises support for compressed responses and transparently decompresses them when supported by the server.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.enableCompression(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__ENABLE_COMPRESSION

Maximum HTTP chunk size in bytes.

This controls the underlying Vert.x HTTP parser chunk size. For most users the default is sufficient; only adjust if you need fine-grained control over streaming behaviour.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.maxChunkSize(int).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__MAX_CHUNK_SIZE

Maximum content length (in bytes) for HTTP/2 clear-text upgrade (h2c).

Controls the threshold used when upgrading HTTP/1.1 connections to HTTP/2 without TLS.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.http2UpgradeMaxContentLength(int).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__HTTP2_UPGRADE_MAX_CONTENT_LENGTH

How multiple query parameters with the same name are encoded.

Valid values correspond to org.jboss.resteasy.reactive.common.jaxrs.MultiQueryParamMode: for example COMMA, DUPLICATE, ARRAY.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.multiQueryParamMode(MultiQueryParamMode).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__MULTI_QUERY_PARAM_MODE

Whether to trust all TLS certificates.

Warning: enabling this effectively disables certificate validation and should only be used in development or controlled environments.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.trustAll(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__TRUST_ALL

Whether to verify the remote TLS hostname.

When false, hostname verification is disabled. This is insecure and should only be used in development or with great care in production.

Default client:

Named client:

Internally mapped to ClientBuilderImpl.verifyHost(boolean).

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_NAMED__NAMED__VERIFY_HOST

Client name to use for all HTTP/OpenAPI tasks in this workflow when there is no task-level override.

Property:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_WORKFLOW__WORKFLOW__NAME

Client name to use for this specific task.

Property:

Environment variable: QUARKUS_FLOW_HTTP_CLIENT_WORKFLOW__WORKFLOW__TASK__TASK__NAME

Register default consumer/publisher beans bound to 'flow-in'/'flow-out' channels

Environment variable: QUARKUS_FLOW_MESSAGING_DEFAULTS_ENABLED

Register the default events lifecycle publisher to the 'flow-lifecycle-out'. By default, the application won’t publish any lifecycle event to this channel.

Environment variable: QUARKUS_FLOW_MESSAGING_LIFECYCLE_ENABLED