Docker image environment variables
These are container-level variables for the Console Docker image, distinct from theplatform-config properties documented below.
Configure Console properties
You can configure Console via environment variables or using the YAML file. Environment variables can be set on the container or imported from a file. When importing from a file, mount the file into the container and provide its path by setting the environment variableCDK_ENV_FILE. Use the .env file with key value pairs.
Sourcing environment variables from $CDK_ENV_FILE, or warn if set and the file is not found
Lists start at index 0 and are provided using the
_idx_ syntax.If you set both the environment variable and a YAML value for a specific field, the environment variable will take precedence.YAML property cases
YAML configuration supports multiple case formats (camelCase/kebab-case/lowercase) for property fragments such as:
clusters[].schemaRegistry.ignoreUntrustedCertificateclusters[].schema-registry.ignore-untrusted-certificateclusters[].schemaregistry.ignoreuntrustedcertificate
Environment variable conversion
At startup, Conduktor Console will merge environment variables and YAML based configuration files into one unified configuration. The conversion rules are:- Filter for environment variables that start with
CDK_ - Remove the
CDK_prefix - Convert the variable name to lower case
- Replace
_with.for nested properties - Replace
_[0-9]+_with[0-9].for list properties. Lists start at index 0.
CDK_DATABASE_URL will be converted to database.url; CDK_SSO_OAUTH2_0_OPENID_ISSUER will be converted to sso.oauth2[0].openid.issuer.
The YAML equivalent would be:
When converting environment variables to YAML configuration, environment variables in
UPPER-KEBAB-CASE will be converted to kebab-case in the YAML configuration.Conversion edge cases
Because of YAML multiple case formats support, the conversion rules have some edge cases when trying to mix environment variables and YAML configuration. Extra rules when mixing environment variables and YAML configuration:- Don’t use
camelCasein YAML configuration. Usekebab-caseorlowercase - Stick to one compatible case format for a given property fragment using the following compatibility matrix
For example, the
CDK_CLUSTERS_0_SCHEMAREGISTRY_IGNOREUNTRUSTEDCERTIFICATE environment variable :
CDK_CLUSTERS_0_SCHEMA-REGISTRY_IGNORE-UNTRUSTED-CERTIFICATE environment variable.
That’s why camelCase is not recommended in YAML configuration when mixing with environment variables.
Shell expansion in the YAML configuration file
Console supports shell expansion for environment variables and home tilde~. This is useful if you have to use custom environment variables in your configuration.
For example, you can use the following syntax:
YAML configuration file
This will be expanded to:
Expanded configuration
If you want to escape the shell expansion, you can use the following syntax:
$$. For example, if you want admin.password to be secret$123, set admin.password: "secret$$123".Support for *_FILE environment variables
When an environment variable ending with_FILE is set to a file path, its corresponding unprefixed environment variable will be replaced with the content of that file.
For instance, if you set CDK_LICENSE_FILE=/run/secrets/license, the value of CDK_LICENSE will be overridden by the content of the file located at /run/secrets/license.
The
CDK_IN_CONF_FILE is not supported.Core properties
Global properties
Database properties
Console uses PostgreSQL to persist application state and operational data. The database maintains user accounts and their group memberships, along with associated permissions and role-based access controls. It also stores your cluster definitions and connection details, indexed metadata from connected clusters (including topics, schemas, and connectors), alert configurations and audit log entries that track system activity.
Example configuration for PostgreSQL connection options:
CDK_DATABASE_URL. The equivalent of the above configuration is:
keepaliveTimeconnectionTimeoutidleTimeoutmaxLifetime
socketTimeout=900 (seconds), tcpKeepAlive=true and keepaliveTime=300000 (milliseconds). With these defaults, a single statement that runs for more than 15 minutes fails. Database migrations at startup aren’t affected. To change a value, set it in database.options or in CDK_DATABASE_URL.
Session lifetime properties
Local user properties
Optional local accounts list, used to log into Console.Monitoring and observability properties
Monitoring properties
We provide a pre-configured monitoring solution based on Cortex (conduktor/conduktor-console-cortex). It’s a custom implementation of Prometheus used in several production systems including Amazon Managed Service for Prometheus (AMP).
If using your own solution, set the monitoring.backend property. We support Cortex, Mimir and Prometheus.
You can choose to not deploy any monitoring solution. If none is deployed, you won’t be able to see the monitoring graphs or configure alerts.
Depending on the chosen solution, you’ll need to provide the corresponding URL and other properties. The mandatory column indicates whether the property is required for the chosen backend.
For example, if you choose mimir, you have to provide the monitoring.mimir-url property but if you select conduktor, you have to provide the monitoring.cortex-url.
If an alert manager URL isn’t provided, Console will use its built-in alert system.
monitoring.use-aggregated-metrics and monitoring.enable-non-aggregated-metrics are temporary flags to help you transition to the new metrics collection system. They will be removed in a future release.Swap their default value if you experience performance issues when Console is connected with large Kafka clusters:Client metrics properties
These properties control how Console collects client metrics (preview) for every cluster that declares a collector. Declare the collectors themselves on each cluster withclusters[].clientMetricsCollectors. Since 1.49.0.
Authentication (SSO) properties
LDAP properties
OAuth2 properties
JWT auth properties
Kafka properties
Kafka cluster properties
Kafka vendor-specific properties
Note that you only need to set the Kafka cluster properties to use the core features of Console. For additional benefits though, set the flavor of your cluster. To define that, go to Settings > Clusters and open the Provider tab. For Confluent Cloud and Confluent Platform flavors, you can enable RBAC (role-based access control) role bindings so that Self-service manages permissions through role bindings instead of Kafka ACLs. The role binding properties below become mandatory whenenableRbacRoleBindings is true. Find out more about migrating to Confluent Cloud or Confluent Platform RBAC role bindings.
Schema registry properties
Amazon Glue properties
Kafka Connect properties
ksqlDB properties
Indexing properties
Indexing fetches metadata from your Kafka cluster (e.g. topics, consumer groups, subjects). You should only modify these parameters if you see an issue with the performance.Console 1.41.0 merged the monitoring indexer into the metadata indexer. The
CDK_MONITORINGCONFIG_* variables no longer have any effect. Use the metadata indexer settings (CDK_METADATAINDEXER_*) below instead.Indexer watchdog properties
Indexer tasks run continuously, but they can occasionally stop for no clear reason. To handle this, Console includes an indexer watchdog that periodically checks the state of indexer tasks. If an indexer’s state is stale (no update within the configured threshold), the watchdog restarts all indexer tasks.Audit log export properties
The audit log can be exported to a Kafka topic, once configured in Console.Data properties
Conduktor SQL properties
In order to use Conduktor SQL, you need to configure a second database to store the Topics data. You can configure Conduktor SQL Database usingCDK_KAFKASQL_DATABASE_URL or alternatively, set each value individually CDK_KAFKASQL_DATABASE_*.
Find out more about database properties.
These are advanced properties that typically won’t need to be changed.
Data quality properties
These are advanced properties that typically won’t need to be changed:- Policies and violations: how Console deploys Policies and reports violations.
without_gatewayproperties only apply to clusters without Gateway. - Overview page: how Console refreshes the overview metrics.
Data quality Policies and violations
Data quality overview page
Data policy properties
These are advanced properties that typically won’t need to be changed.Consume rate limit properties
Cap how many live consume sessions run at the same time. Both limits are off (0) by default. See Limit concurrent live consume sessions. Since 1.49.0.
Stream lineage properties
These properties control Stream lineage graph caching and live throughput in Console.Advanced properties
Global search properties
These properties control global search, which finds resources and pages from the Console top bar. The defaults suit most deployments. Available since 1.49.0.Timeout properties
Console puts a time limit on the calls it makes to Kafka, Schema Registry, Confluent Cloud and Gateway during indexing and other background work, so a call that never returns can’t stall that work. The defaults suit most deployments. Raise a value if the Console logs show timeouts against a slow or distant system. Available since 1.49.0.Agents and model connection properties
Conduktor Agents (preview) are turned on and off withenable_agents in the global properties. Agents and Ask run on the model connections declared under models. Each connection is an item of that list, so its environment variables are numbered. The first connection uses CDK_MODELS_0_ID, CDK_MODELS_0_PROVIDER and CDK_MODELS_0_APIKEY.
See the model connection properties for every property, including the Amazon Bedrock and OpenAI-compatible providers added in 1.49.0.
MCP and personal access token properties
These properties control the Conduktor MCP server and the personal access tokens that users create under Settings > API Keys. To turn the MCP server off altogether, useenable_mcp in the global properties. Find out how to choose which tokens MCP accepts. Available since 1.49.0.
Ask properties
These properties control Ask (preview), the assistant in Console. Ask also needsenable_agents and at least one model connection. Available since 1.49.0.