Confluent CLI Release Notes

Note that the Confluent CLI is continuously updated with improvements and new features. This page highlights significant user-facing features and updates to the interface.

[9/25/2023] Confluent CLI v3.35.0 Release Notes

New Features

• Add confluent kafka consumer group describe
• Add confluent kafka consumer group list
• Add confluent kafka consumer list

Bug Fixes

• Correctly format timestamps in YAML output

[9/21/2023] Confluent CLI v3.34.0 Release Notes

New Features

• If available, display RBAC role binding ID in confluent iam rbac role-binding commands
• Add confluent kafka partition describe and confluent kafka partition list cloud commands

Bug Fixes

• Add the missing --output flag to confluent kafka link describe and remove the unused --force flag
• Verify Java version at the beginning when running confluent local services start

[9/14/2023] Confluent CLI v3.33.0 Release Notes

New Features

• Added confluent connect custom-plugin commands

Bug Fixes

• Fix a bug in context decryption after running confluent context update --name
• Fix a bug where custom connectors no longer require “connector.class” in confluent connect cluster create
• Fix a panic that occurs when using confluent kafka topic consume --key-format with a schema-based key format

[9/7/2023] Confluent CLI v3.32.0 Release Notes

New Features

• Add --jit-enabled to allow customer to toggle the JUST-IN-TIME for SSO enabled organization
• Add --brokers flag in confluent local kafka start to allow starting a multi-broker Confluent Local instance
• Add confluent local kafka broker command
• Add confluent local kafka cluster configuration command

Bug Fixes

• Fix a bug in confluent iam user invitation list where only the first 100 results were listed
• Fix an issue causing confluent kafka topic consume to deserialize integers to incorrect values when using --key-format integer or value-format integer
• Resolve a panic that could occur in confluent kafka topic consume when using --key-format integer and --print-key
• --parse-key must now be specified when using confluent kafka topic produce --key-format

[9/5/2023] Confluent CLI v3.31.0 Release Notes

New Features

• Add confluent iam service-account use and confluent iam service-account unset

Bug Fixes

• Fix an incorrect URL causing confluent plugin search and confluent plugin install to fail

[8/24/2023] Confluent CLI v3.30.0 Release Notes

New Features

• Add support for multiple arguments to delete commands

Bug Fixes

• Resolve a panic in confluent iam rbac role-binding list
• After session has timed out, correctly refresh credentials with environment variables or credentials saved with confluent login --save

[8/17/2023] Confluent CLI v3.29.0 Release Notes

New Features

• Add --all to confluent kafka acl list to include deleted ACLs whose principals are integer IDs
• Add confluent configuration commands for configuration file management
• Add confluent schema-registry config delete command

Bug Fixes

• Fix a flaky panic that occurred when pressing Ctrl-C in confluent kafka topic produce
• Fix a panic that occurred when /dev/tty was inaccessible in confluent flink shell

[8/11/2023] Confluent CLI v3.28.0 Release Notes

New Features

• confluent local services commands were dropped from v3.16.0 to v3.26.0, but are back as of v3.27.0 and will be supported until the next major version release (v4.0.0). These will be replaced by faster comparable commands with the syntax confluent local <name-of-service>. The first of these, confluent local kafka, is already present in the CLI.
• Add support for both strings and files for the --config flag, in all relevant confluent kafka and confluent schema-registry commands
• Support --key-format integer and --value-format integer in confluent kafka topic produce and confluent kafka topic consume

Bug Fixes

• Resolve a panic that can happen when exiting confluent kafka topic produce with Ctrl-C on Windows
• confluent kafka topic consume --group will start consuming from the offset that it exited with last time
• Prevent errors for certain statuses in confluent kafka mirror describe and confluent kafka mirror list

[8/7/2023] Confluent CLI v3.27.0 Release Notes

New Features

• Support --protocol PLAINTEXT in confluent kafka topic consume
• Enable Schema Registry to be used without authentication on-premises, for the purpose of demos

Bug Fixes

• Fix authentication issue in confluent kafka topic [produce | consume] on Windows
• Fix panic in confluent api-key store --resource
• Prevent “flag accessed but not defined” error in confluent schema-registry commands

[8/3/2023] Confluent CLI v3.26.0 Release Notes

New Features

• Add --key-format, --key-schema, and --key-references to kafka topic produce
• Add --key-format to kafka topic consume
• Suggest updating with brew upgrade if installed with Homebrew

[7/27/2023] Confluent CLI v3.25.0 Release Notes

New Features

• Add confluent feedback for user-submitted feedback
• When authenticated with Confluent Cloud, no longer require an API key for Schema Registry operations
• Add confluent kafka cluster configuration commands for managing dedicated cluster configurations

Bug Fixes

• Correctly display Confluent Platform mirror topics in confluent kafka link list --include-topics
• Fix confluent asyncapi import and confluent asyncapi export to follow AsyncAPI documentation for Kafka channel bindings, with explicit fields for bindingVersion, partitions, and topicConfiguration
• Improve error message when no API secret is provided to confluent kafka client-config create

[7/21/2023] Confluent CLI v3.24.0 Release Notes

New Features

• Allow changing default port numbers in confluent local kafka start with the --kafka-rest-port and --plaintext-port flags
• Print progress while downloading Docker image in confluent local kafka start
• Print the ports that Confluent Local is using when running confluent local kafka start
• Autocomplete flags in confluent kafka client-config create commands
• Add autocompletion to confluent kafka topic produce and confluent kafka topic consume
• List and install plugins from the official Confluent CLI plugin repository with confluent plugin search and confluent plugin install

Bug Fixes

• Fix autocompletion of --availability and --type flags in confluent kafka cluster create

[7/14/2023] Confluent CLI v3.23.0 Release Notes

New Features

• Add a suggestion to use confluent kafka cluster when users run the on-premises confluent cluster command while logged in to Confluent Cloud
• Support passing schema IDs to the --schema flag in confluent kafka topic produce

[7/13/2023] Confluent CLI v3.22.0 Release Notes

New Features

• Improve the error message when a user runs an on-premises command while logged into Confluent Cloud
• Bidirectional link support for confluent kafka link
• No longer require passing the --resource flag to confluent api-key use

Bug Fixes

• Prevent a panic when passing a non-existent Kafka cluster to confluent api-key store --resource
• Fix “type” output in confluent schema-registry schema describe and properly format Avro schemas
• Print an error message when confluent local kafka start is run from an AMD64 binary on an ARM64 machine

[7/6/2023] Confluent CLI v3.21.0 Release Notes

New Features

• Add confluent pipeline create --use-schema-registry, and by default do not add Schema Registry to pipelines

Bug Fixes

• Fix misleading error messages in confluent kafka topic consume

[6/29/2023] Confluent CLI v3.20.0 Release Notes

New Features

• Autocompletion for confluent api-key create --resource
• Add confluent kafka link describe

Bug Fixes

• Fixes the 404 error when creating a role binding attached to an identity pool

[6/23/2023] Confluent CLI v3.19.0 Release Notes

New Features

• Encrypt API key pair in context credentials

Bug Fixes

• Fix permission issue while running confluent update in Docker image

[6/15/2023] Confluent CLI v3.18.0 Release Notes

New Features

• Add confluent connect plugin install command to install Connect plugins for Confluent Platform
• Support calling confluent environment describe without arguments
• Autocomplete arguments in confluent service-quota list

Bug Fixes

• Prevent panic while retrieving Schema Registry cluster information

[6/8/2023] Confluent CLI v3.17.0 Release Notes

New Features

• Add confluent billing cost list

Bug Fixes

• Fix confluent update checksum validation for Alpine Linux

[6/2/2023] Confluent CLI v3.16.0 Release Notes

New Features

• Added new Docker-based confluent local commands for improved local testing of Confluent Platform

Bug Fixes

• Removed unused --output flag in confluent kafka topic consume

[5/25/2023] Confluent CLI v3.15.0 Release Notes

New Features

• Support topic prefixes ending with a wildcard (*) in confluent asyncapi export --topics
• Update “num.partitions” for a Kafka topic with confluent kafka topic update --config

[5/18/2023] Confluent CLI v3.14.0 Release Notes

New Features

• Publish with Homebrew
• Add --metadata and --ruleset to confluent schema-registry schema create
• Add --compatibility-group, --metadata-defaults, --metadata-overrides, --ruleset-defaults, and --ruleset-overrides to confluent schema-registry subject update

Bug Fixes

• Fix decryption error when running non-authenticated commands
• Correctly display mirror topics in confluent kafka link list --include-topics

[5/12/2023] Confluent CLI v3.13.0 Release Notes

New Features

• Publish linux/arm64 Docker image

Bug Fixes

• Allow plugins whose filepath starts with ~ to run
• Fix service account error in confluent api-key create when audit logs are disabled

[5/4/2023] Confluent CLI v3.12.0 Release Notes

New Features

• Add --topics flag to confluent asyncapi export to only export specified topics

[4/28/2023] Confluent CLI v3.11.0 Release Notes

New Features

• Add a new --all flag to confluent schema-registry schema list to include soft-deleted schemas in the output

Bug Fixes

• Schemas can now be permanently deleted with confluent schema-registry schema delete when using --version all

[4/13/2023] Confluent CLI v3.10.0 Release Notes

New Features

• Add argument autocompletion for confluent iam, confluent kafka, and confluent pipeline commands
• Support for topic partition count in confluent asyncapi export
• Add --context flag to all confluent environment subcommands

Bug Fixes

• Display a warning instead of an error if the topic count is not found in confluent kafka cluster describe
• Allow more than 10 KSQL clusters to be listed in confluent ksql cluster list

[4/7/2023] Confluent CLI v3.9.0 Release Notes

New Features

• Add argument autocompletion for confluent api-key describe
• Add support for autocompleting multiple arguments for confluent connect cluster pause and confluent connect cluster resume
• Add --ksql-cluster and --update-schema-registry to confluent pipeline update

[3/31/2023] Confluent CLI v3.8.0 Release Notes

New Features

• Add confluent schema-registry region list command

Bug Fixes

• Fix a bug on Windows preventing decryption of authentication tokens
• Fix confluent update for Windows

[3/30/2023] Confluent CLI v3.7.0 Release Notes

New Features

• Add confluent asyncapi import command
• Add suggestions to check CLI’s access to /etc when encryption fails
• Improve documentation for confluent iam acl commands

Bug Fixes

• Correct filename autocompletion for avsc files

[3/23/2023] Confluent CLI v3.6.0 Release Notes

New Features

• When specifying a file with a flag, auto-complete according to file extension

Bug Fixes

• Prevent panics in confluent kafka cluster use and confluent api-key commands for users without an environment
• Fixed a decryption error when running confluent context list with old contexts from ~/.confluent/config.json

[3/17/2023] Confluent CLI v3.5.2 Release Notes

Bug Fixes

• Prevent a panic that could occur in various confluent api-key commands

[3/16/2023] Confluent CLI v3.5.1 Release Notes

Bug Fixes

• Fix an issue where confluent schema-registry schema delete --permanent prevents permanent deletion of schema versions
• Allow confluent kafka topic produce to run when using a context created with confluent context create
• Ignore Protobuf schemas in confluent asyncapi export
• Correctly propagate backend errors in confluent kafka quota list
• Allow primitive Avro schemas in confluent asyncapi export

[3/7/2023] Confluent CLI v3.5.0 Release Notes

New Features

• Add confluent organization describe, list, and update

Bug Fixes

• Disable plugins by default on Windows, but allow manual re-enablement in ~/.confluent/config.json
• Fix cipher: message authentication failed issue on Alpine image

[3/2/2023] Confluent CLI v3.4.0 Release Notes

New Features

• Format JSON output in confluent schema-registry schema describe
• Add the --use flag to confluent api-key create to select an API key after it has been created
• Add jq to Docker image
• Update description of confluent login --save to mention that credentials will also be saved to keychain on macOS
• Improve error messages for when a Kafka cluster is deleted from outside of the CLI
• Display a warning message when a command requires an active environment, but no environment is selected

Bug Fixes

• Ignore the “Current” column when sorting the output of list commands
• Prevent empty flag values from being passed in confluent price list
• Validate nonce length to avoid a panic while encrypting or decrypting login credentials
• Prevent a panic that could occur when using commands with the --environment flag
• Fix examples for on-prem confluent kafka acl create
• Use $PATHEXT to correctly determine if a plugin is executable on Windows

[2/23/2023] Confluent CLI v3.3.0 Release Notes

New Features

• Add confluent byok (Bring Your Own Key) commands for customer-managed keys in Confluent Cloud

Bug Fixes

• Resolve a panic that could occur in confluent api-key list

[2/21/2023] Confluent CLI v3.2.1 Release Notes

Bug Fixes

• Fix a panic that could occur in confluent asyncapi export when using protobuf schemas
• Fix an issue preventing users from successfully using confluent login in a Docker container
• Fix a panic that could occur in confluent schema-registry cluster describe
• Update ingress/egress limits to correct values in confluent kafka cluster describe

[2/17/2023] Confluent CLI v3.2.0 Release Notes

Breaking Changes

• Confluent Cloud sign-up in the CLI has been removed. confluent cloud-signup now opens the sign-up page in the user’s browser

New Features

• Encrypt authenticated context and login credentials on local storage

Bug Fixes

• Fixed an issue in confluent api-key list. Users with DeveloperRead/Write/Manage roles can list API keys to which they have access.
• The Kafka cluster name is not updated when it’s not specified in confluent kafka cluster update

[2/9/2023] Confluent CLI v3.1.1 Release Notes

Bug Fixes

• Fix panic in confluent kafka link list
• Fix inefficiencies while searching $PATH for plugins
• Standardize flag value format across all examples

[2/3/2023] Confluent CLI v3.1.0 Release Notes

New Features

• confluent plugin list will now display an error if plugins are disabled
• Add informative examples of the --inclusive flag in confluent iam rbac role-binding list

Bug Fixes

• Fix an issue causing confluent iam rbac role-binding create to display an error despite successfully creating the role-binding when the principal is a service account

[1/31/2023] Confluent CLI v3.0.1 Release Notes

Bug Fixes

• Fix a bug causing the “Activation Privilege” field to always show “false” in the output of confluent pipeline commands
• Fix issues in confluent iam rbac role-binding list which could cause a “400 Bad Request” error when listing role bindings for a service account
• Various updates to the formatting of error messages and examples

[1/25/2023] Confluent CLI v3.0.0 Release Notes

Confluent CLI is now source-available under the Confluent Community License. For more details, check out the Announcing the Source Available Confluent CLI blog post.

Breaking Changes

• Default to HTTPS for on-prem login with confluent login
• Require acknowledgment before deleting any resource, and use --force flag to skip acknowledgment
• Use correct and consistent JSON and YAML formatting across all commands
• Remove leading “v” from archive names, so the format matches binary names
• Place asterisk in “Current” column in confluent api-key list, confluent environment list, and confluent kafka list
• Delete confluent ksql app commands in favor of confluent ksql cluster commands
• In confluent iam rbac role-binding list, combine “Service Name” and “Pool Name” into “Name”
• In confluent iam rbac role-binding list, require the --inclusive flag to list role bindings in nested scopes
• Move Connect cluster management commands under confluent connect cluster
• Prevent using numeric IDs for confluent kafka acl commands
• Print a table instead of a list in confluent schema-registry compatibility validate and confluent schema-registry config describe
• Remove the “KAPI” field, “API Endpoint” field, and the corresponding --all flag from confluent kafka cluster describe
• Remove shorthand flags: -D, -P, -r, -S, and -V
• Rename “Exporter” to “exporter” in serialized output for confluent schema-registry exporter list
• Rename “task” to “tasks” in confluent connect cluster describe
• Rename --current-env to --current-environment
• Rename --no-auth to --no-authentication
• Rename --operation to --operations where appropriate
• Rename --refs to --references
• Rename --show-refs to --show-references
• Rename --sr-apikey and --sr-api-key to --schema-registry-api-key
• Rename --sr-apisecret and --sr-api-secret to --schema-registry-api-secret
• Rename --sr-endpoint to --schema-registry-endpoint
• Rename confluent audit-log migrate config to confluent audit-log config migrate
• Rename confluent kafka link describe to confluent kafka link configuration list
• Rename confluent kafka partition get-reassignments to confluent kafka partition reassigments list
• Rename values for confluent price list --cluster-type
• Replace all instances of “First Name” and “Last Name” with “Full Name”
• Require --environment in confluent schema-registry cluster delete

New Features

• Use Kafka REST for all confluent kafka commands
• Remove login requirement for confluent secret commands
• Add “Read Only” column to confluent kafka topic describe
• Add detailed Kafka REST examples for confluent kafka acl commands

[5/17/2023] Confluent CLI v2.38.1 Release Notes

Bug Fixes

• Encrypt authenticated context and login credentials on local storage

[1/12/2023] Confluent CLI v2.38.0 Release Notes

New Features

• Add --activation-privilege flag to confluent pipeline update
• Add “Secret Names” field to confluent pipeline commands
• Improve examples for confluent iam rbac role-binding create

[12/15/2022] Confluent CLI v2.37.0 Release Notes

New Features

• Add --ksql-cluster flag in confluent iam role-binding and confluent iam role

Bug Fixes

• Resolve panic when logging in to Confluent Cloud without a valid role binding or environment
• Print missing “KafkaRestProduce” metric in confluent price list

[12/8/2022] Confluent CLI v2.36.0 Release Notes

New Features

• Add --schema-registry-cluster-id to confluent iam rbac role-binding commands
• Add “Free Schemas Limit” field to confluent schema-registry cluster describe

[12/2/2022] Confluent CLI v2.35.0 Release Notes

New Features

• Add a disable_feature_flags option to the configuration file

Bug Fixes

• Fix an issue in confluent asyncapi export which could cause repeated topic descriptions

[11/29/2022] Confluent CLI v2.34.0 Release Notes

New Features

• Add warning about required privileges to confluent ksql cluster create
• Update on-prem examples for confluent kafka topic commands

Bug Fixes

• Fix a bug causing repeated tags in confluent asyncapi export
• Fix bug in confluent iam rbac role-binding create that could prevent creation when using the --resource flag
• Fix empty list bug in confluent iam rbac role-binding list when using the --resource flag

[11/17/2022] Confluent CLI v2.33.0 Release Notes

New Features

• Export AsyncAPI specification files with confluent asyncapi export

Bug Fixes

• Show logical KSQL cluster IDs in confluent iam rbac role-binding list
• Fix HTTP status code error in confluent ksql cluster configure-acls
• Fix 0 partition error in confluent kafka topic create

[11/15/2022] Confluent CLI v2.32.1 Release Notes

Bug Fixes

• Fix replication factor error in confluent kafka topic create
• Print mirror topic name instead of source topic name in confluent kafka mirror create

[11/3/2022] Confluent CLI v2.32.0 Release Notes

New Features

• Improve error messages when users provide an incorrectly formatted Kafka cluster ID

Bug Fixes

• Fix CLI panic when setting environment in configuration

[10/27/2022] Confluent CLI v2.31.0 Release Notes

New Features

• Allow multiple connectors to be paused and resumed at once
• Allow all flags accepting lists to accept comma-separated lists of strings
• Add --environment flag to confluent api-key list
• Verify that a cluster exists before unregistering it with confluent cluster unregister

Bug Fixes

• Only check for plugins in top-level directories within $PATH
• Fix index out of range error in confluent ksql cluster configure-acls
• Allow users with no role bindings to log in
• Fix race condition during in-browser SSO login
• Allow password prompt to be interrupted with Ctrl+C
• Fix misleading error message in confluent api-key store

[10/21/2022] Confluent CLI v2.30.1 Release Notes

Bug Fixes

• Fix an app notarization issue affecting Darwin builds

[10/21/2022] Confluent CLI v2.30.0 Release Notes

New Features

• Add confluent schema-registry schema list

Bug Fixes

• Fix an issue preventing confluent kafka cluster describe from being called on a provisioning cluster
• Improve error messaging in confluent kafka topic and confluent kafka acl commands
• Fix panic that could occur in some confluent kafka commands

[10/13/2022] Confluent CLI v2.29.0 Release Notes

New Features

• Show more detailed error message in confluent api-key use

[5/3/2023] Confluent CLI v2.28.2 Release Notes

Bug Fixes

• Encrypt authenticated context and login credentials on local storage

[10/6/2022] Confluent CLI v2.28.1 Release Notes

Bug Fixes

• Fix “unspecified resource type” error when describing or deleting Kafka ACLs

[10/3/2022] Confluent CLI v2.28.0 Release Notes

New Features

• General updates and improvements

[9/29/2022] Confluent CLI v2.27.0 Release Notes

New Features

• Confluent CLI is now available for Linux and Alpine Linux on ARM64 architecture
• Added Topic Count field in confluent kafka cluster describe and confluent kafka cluster update

Bug Fixes

• The Error field in confluent kafka link list will now be empty instead of printing NO_ERROR when the link is not in an error state

[9/22/2022] Confluent CLI v2.26.0 Release Notes

New Features

• Display State, Error and Error Message in confluent kafka link list
• Show more detailed error messages for Confluent Cloud API routes

[9/13/2022] Confluent CLI v2.25.0 Release Notes

New Features

• Add confluent environment describe
• Add confluent api-key describe
• The -vvv flag now notifies the user that $PATH is recursively searched for plugins

Bug Fixes

• Fix the example for confluent kafka acl create
• Allow deletion of ksqlDB clusters that failed to provision

Note

The new CLI plugins functionality, introduced in v2.24.0, searches your entire $PATH and can cause slow response time.

If you are experiencing CLI commands hanging, set the following in the ~/.confluent/config.json file to disable the plugins:

"disable_plugins": true

[8/22/2022] Confluent CLI v2.24.2 Release Notes

Bug Fixes

• Fix 404 error for kafka acl commands
• Fix non-root user in Docker image

[8/21/2022] Confluent CLI v2.24.1 Release Notes

Bug Fixes

• --unsafe-trace works with every command that uses HTTP
• Fix panic that could occur when user was unauthenticated

[8/18/2022] Confluent CLI v2.24.0 Release Notes

New Features

• Added plugin framework and confluent plugin list command
• Signed Windows binaries
• Add non-root user to Dockerfile
• Added examples for confluent login
• Warn when updating read-only topic configurations in confluent kafka topic update

Bug Fixes

• Add global --unsafe-trace flag
• Netrc auto-login should use the current context
• Update command list on login in confluent shell
• Prevent error when fetching Kafka cluster from within an API key context
• Improve error messages in confluent kafka topic create

[7/28/2022] Confluent CLI v2.23.0 Release Notes

Bug Fixes

• Correctly identify Confluent Cloud contexts created with confluent context create
• Fix panic when running confluent local services connect start without “plugin.path”

[7/20/2022] Confluent CLI v2.22.0 Release Notes

New Features

• Add confluent iam user update
• Add --package flag to confluent schema-registry cluster enable --package
• Add confluent schema-registry cluster upgrade
• Improve error message when trying to delete a cluster with active connectors
• Add “Detailed Processing Log” field to confluent ksql cluster create and confluent ksql cluster describe
• Add “Usage” field to confluent service-quota list

Bug Fixes

• Properly identify organizations on free trial
• Fix panic when creating kSQL API keys with confluent api-key create exceeds the quota
• Reformat error message when shrinking a cluster by more than 1 CKU in confluent kafka cluster update

[7/11/2022] Confluent CLI v2.21.0 Release Notes

New Features

• Add confluent iam service-account describe
• Show more detailed error messages for Confluent Cloud API routes

Bug Fixes

• Fix issue where organizations are marked as suspended, even after being reactivated

[6/30/2022] Confluent CLI v2.20.0 Release Notes

New Features

• Support --dry-run and --no-validate flags for confluent kafka link create

Bug Fixes

• Refresh cached Kafka cluster metadata on a weekly basis, instead of infinitely

[5/8/2023] Confluent CLI v2.19.1 Release Notes

Bug Fixes

• Encrypt authenticated context and login credentials on local storage

[6/23/2022] Confluent CLI v2.19.0 Release Notes

New Features

• Improve free remaining credit message in confluent login and confluent cloud-signup

[6/16/2022] Confluent CLI v2.18.0 Release Notes

New Features

• Show service account role bindings in confluent iam role-binding list
• Improve examples for confluent ksql cluster create
• Make errors more descriptive in confluent api-key create
• Add “Service Provider Region” and “Package” fields to confluent schema-registry cluster describe
• Add --source-topic flag to confluent kafka mirror topic create

Bug Fixes

• Allow configuration values to contain commas in --config

Confluent CLI v2.17.2 Release Notes

Bug Fixes

• When running confluent update, Alpine Linux users will update to a statically-linked CLI build, while other users will update to a dynamically-linked CLI build. See Prerequisites for details.
• On Alpine Linux, you cannot use confluent update to update from Confluent CLI versions earlier than v2.17.2. The confluent update command works for v2.17.2 or later. From the older versions, use curl or tarball installation to update to the latest version. See Install Confluent CLI for details.

Confluent CLI v2.17.1 Release Notes

New Features

• When running confluent update, Alpine Linux users will update to a statically-linked CLI build, while other users will update to a dynamically-linked CLI build.

Confluent CLI v2.17.0 Release Notes

New Features

• Allow suspended users to connect a credit card and redeem promo codes
• Add confluent schema-registry cluster delete

Bug Fixes

• Improve error message when running confluent kafka topic produce <topic> --value-format without a schema path or schema ID specified

Confluent CLI v2.16.0 Release Notes

New Features

• Retry 5 times if request fails in a subset of commands.
• Add --offset flag to confluent kafka topic consume command, allowing users to set an offset from the beginning to consume from
• Add --partition flag to confluent kafka topic consume command, allowing users to consume from a certain partition of topic

Bug Fixes

• Fix environment not found in context error when passing audit log or connect event environment via --environment flag
• Remove the null byte prepended to messages when running confluent kafka topic consume command without a schema

Confluent CLI v2.15.1 Release Notes

Bug Fixes

• Resolve auth token refresh failure for a group of SSO users

Confluent CLI v2.15.0 Release Notes

New Features

• Add the ability to disable cloud features in the event of a security incident
• Clarify that confluent login --save should not be used with SSO login

Confluent CLI v2.14.0 Release Notes

New Features

• Added confluent schema-registry exporter commands for Confluent Platform
• Return a more specific error message if resource quota limits are exceeded

Bug Fixes

• Ignore redundant --save flag at confluent login for SSO users

Confluent CLI v2.13.2 Release Notes

Bug Fixes

• Fix panic on confluent login when user context is not defined

Confluent CLI v2.13.1 Release Notes

Bug Fixes

• If user is already authenticated with a username and password, confluent login will prompt for new credentials instead of refreshing the existing session

Confluent CLI v2.13.0 Release Notes

New Features

• Automatically refresh sessions, keeping users logged in while the CLI is in use
• Add --principal flag to confluent kafka acl commands for filtering by service account or user
• Add --config, --config-file, and --schema-id flags to confluent kafka topic produce and confluent kafka topic consume
• Improve documentation for confluent kafka topic, confluent ksql, and confluent secret

Bug Fixes

• Fix typos in various command descriptions

Confluent CLI v2.12.0 Release Notes

New Features

• Let --kafka-cluster-id imply --cloud-cluster in confluent iam rbac role-binding list
• In confluent schema-registry describe optionally print the entire schema graph

Bug Fixes

• Add dataplane roles to suggestion message in iam rbac role describe
• Delete temporary schema directories after producing or consuming
• Remove redundant log messages during API pagination

Confluent CLI v2.11.0 Release Notes

New Features

• Add --full-header flag to confluent kafka topic consume to print untruncated message headers
• Add support for source-initiated cluster links in Confluent Cloud

Bug Fixes

• Validate --geo flag values when creating Schema Registry clusters
• Show all available roles with confluent iam rbac role list
• Fix error message when resizing a Kafka cluster

Confluent CLI v2.10.1 Release Notes

Bug Fixes

• Add back -D shorthand for --deleted flag in schema-registry subject describe

Confluent CLI v2.10.0 Release Notes

New Features

• New commands for Confluent Cloud: schema-registry compatibility and schema-registry config
• New commands for Confluent Platform: schema-registry compatibility, schema-registry config, schema-registry subject, and schema-registry schema

Bug Fixes

• Fix bug where locally stored API key could be cleared
• Refresh SSO tokens on auto-login

Confluent CLI v2.9.0 Release Notes

New Features

• Migrated to new APIs that support faster cluster provisioning

Bug Fixes

• Fixed issue that prevented HTTPS_PROXY environment variable from having an effect
• Fixed incorrect options for updating Schema Registry subject modes
• Improved error messages and help examples

Confluent CLI v2.8.1 Release Notes

New Features

• Show user email, organization name, and organization ID on login

Bug Fixes

• Show the correct email when listing API keys for users with dataplane roles

Confluent CLI v2.8.0 Release Notes

New Features

• confluent service-quota list command for Confluent Cloud
• Add schema ID field in confluent schema-registry schema describe output

Bug Fixes

• Fix parsing of quoted flag values and arguments in confluent shell
• Fix parsing of multi-value flags in confluent shell
• Fix error with protobuf schema references for produce and consume commands

Confluent CLI v2.7.0 Release Notes

New Features

• Added confluent kafka client-config commands
• Improved logging for produce and consume commands, and during SSO login
• Added support for multiline properties in cluster link configuration files

Bug Fixes

• Fixed capitalization in human-readable output

Confluent CLI v2.6.2 Release Notes

Bug Fixes

• Encrypt authenticated context and login credentials on local storage

Confluent CLI v2.6.1 Release Notes

New Features

• Improved cipher algorithm used for secret command

Bug Fixes

• Fix issue with updating cluster links

Confluent CLI v2.6.0 Release Notes

New Features

• Verify checksums during confluent update
• Enforce TLS 1.2 or greater
• Added organization ID to login message
• Produce and consume support for Confluent Platform
• Add kafka link commands for Confluent Platform

Bug Fixes

• Allow colons in role binding subject resources
• Improve error when logging in to a suspended org

Confluent CLI v2.5.1 Release Notes

Bug Fixes

• List ACLs created with service account resource IDs in kafka acl list
• Improve suggestion when API key is not recognized as valid

Confluent CLI v2.5.0 Release Notes

Breaking Changes

• Due to backend changes, the --dry-run and --no-validate flags in the kafka link create commands no longer have an effect. Deprecation notices are added to the flag descriptions.

New Features

• Improved shell completions for bash and zsh
• Add ksql cluster commands and add deprecation warnings to ksql app commands

Bug Fixes

• Fix potential panic in kafka cluster describe
• Fix potential request failures for users with large number of resources
• Improvements to error and help messages

Confluent CLI v2.4.0 Release Notes

New Features

• Add support for logging into specific Confluent Cloud organizations
• Update librdkafka to 1.8.2
• Don’t show deactivated users (or those with expired invitations) in role binding list command
• Add on-prem replica management commands
• Improved version of confluent shell command
• Add autocompletion support for remaining command flags (--api-key, --context, --environment)

Bug Fixes

• Fix issue where CLI would not show additional information with verbosity flags set (-v, -vv, -vvv, -vvvv)
• Return error if SSO user enters different emails in CLI prompt and their SSO provider
• Fix regression in --ca-cert-path flag so that it uses absolute filepaths
• Check whether service account exists before attempting to create or delete a Kafka ACL
• Add friendlier error messages for RBAC commands

Confluent CLI v2.3.1 Release Notes

Bug Fixes

• Show the correct error for confluent api-key list and confluent audit-log describe if audit logs are disabled for an organization

Confluent CLI v2.3.0 Release Notes

New Features

• Expand existing autocompletion functionality to include many command arguments and flags
• Add built-in aliases for several long command names
• Add reference support for JSON and protobuf in schema producer and consumer
• Add --subject-format flag to schema-registry exporter commands
• Notify user when ksqlDB cluster provisioning fails
• Add extra validation logic for login URLs
• Warn Confluent Platform users before enabling updates

Bug Fixes

• Create audit log API keys using the correct service account
• Err if a process is already listening on the SSO callback port
• Fix panic when autocompleting service-account commands in confluent shell

Confluent CLI v2.2.0 Release Notes

New Features

• Properly label “PAUSED” ksqlDB clusters

Bug Fixes

• Fix Windows failures due to missing pthreads library
• NOTE: Users of confluent v2.0.0, v2.1.0, or v2.1.1 must manually update to this version with curl -sL https://cnfl.io/cli | sh -s -- -b $(dirname $(which confluent))

Confluent CLI v2.1.0 Release Notes

New Features

• Restore partition count field when describing a topic’s configuration
• Show success message when deleting a service account
• Allow CONFLUENT_PLATFORM_MDS_URL and CONFLUENT_PLATFORM_CA_CERT_PATH to be used with confluent cluster describe

Bug Fixes

• Fix issue with listing pending user invitations
• Fix issue with logging into SSO-enabled organizations when user is not already logged in
• Only auto-login to the current context
• Update description of confluent prompt
• Hide confluent iam acl commands when logged into a cloud context

Confluent CLI v2.0.0 Release Notes

Breaking Changes

• WARNING: If you are updating from a prior Confluent CLI v1.x client, note that this version is NOT interoperable with Confluent Platform v7.0 or earlier. See Supported Versions and Interoperability for full details on CLI client to Confluent Platform interoperability.
• If you are updating from the Confluent Cloud CLI, the client name will change to confluent with this version.
• See Migration Guide for a full list of breaking changes and details regarding differences from v1.x.

New Features

• This version of Confluent CLI supports both Confluent Cloud and Confluent Platform management.

  To use Confluent CLI v2.0 for Confluent Cloud, sign up with confluent cloud-signup or authenticate with confluent login.

Confluent CLI v1.43.2 Release Notes

Bug Fixes

• Encrypt authenticated context and login credentials on local storage

Confluent CLI v1.43.1 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.43.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.42.0 Release Notes

Bug Fixes

• Fix 404 error in confluent kafka acl list

Confluent CLI v1.41.0 Release Notes

New Features

• Add support for managing brokers and partitions

Confluent CLI v1.40.2 Release Notes

Bug Fixes

• Encrypt authenticated context and login credentials on local storage

Confluent CLI v1.40.1 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.40.0 Release Notes

Bug Fixes

• Fix issues when changing directories after logging in with a custom CA cert path
• Make confluent iam rolebinding list support filtering by resource
• Fix confluent iam rolebinding list when no role is specified

Confluent CLI v1.39.1 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.39.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.38.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.37.1 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.37.0 Release Notes

Bug Fixes

• Improved error messaging and help output

Confluent CLI v1.36.0 Release Notes

Bug Fixes

• Fix the issue of inserting + for whitespace in iam rolebinding parameters

Confluent CLI v1.35.0 Release Notes

New Features

• Performance improvements

Bug Fixes

• Show all new release notes on CLI update

Confluent CLI v1.34.0 Release Notes

New Features

• Kafka ACL management via Confluent REST Proxy

Bug Fixes

• Fix logout panic when removing netrc entry

Confluent CLI v1.33.0 Release Notes

New Features

• Remove credentials from .netrc file when logout command is run
• Move non-interactive login/environment messages to debug-level printouts to stderr

Bug Fixes

• Fix supporting custom home directories specified via the $HOME environment variable

Confluent CLI v1.32.0 Release Notes

Bug Fixes

• Fix iam acl create bug for User principals with @ symbol

Confluent CLI v1.31.0 Release Notes

New Features

• Increase default number of metadata key iterations from 1000 to 10000

Confluent CLI v1.30.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.29.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.28.1 Release Notes

Bug Fixes

• Fix bug where update command fails to find some versions

Confluent CLI v1.28.0 Release Notes

New Features

• Improved help text and examples

Confluent CLI v1.27.0 Release Notes

New Features

• Build and release darwin/arm64 binaries and archives

Confluent CLI v1.26.0 Release Notes

New Features

• Topic management commands via Confluent REST Proxy API

Bug Fixes

• Use CONFLUENT_MDS_URL and CONFLUENT_CA_CERT_PATH for login command when set
• Require --role flag for iam rolebinding delete command

Confluent CLI v1.25.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.24.0 Release Notes

New Features

• Non-interactive login
• CONFLUENT_MDS_URL and CONFLUENT_CA_CERT_PATH environment variable support

Confluent CLI v1.23.0 Release Notes

Bug Fixes

• Better handling of --ca-cert-path flag for saved logins

Confluent CLI v1.22.0 Release Notes

New Features

• Stateless mode
• Support self-signed certs for confluent cluster describe

Bug Fixes

• Fix confluent local services start bug for Centos
• Fix no newline bug when auto injected configs are appended to manually added configs for confluent local commands

Confluent CLI v1.21.1 Release Notes

New Features

• Fix case where wrong ca-cert-path might be used when logging in

Confluent CLI v1.21.0 Release Notes

New Features

• --prompt flag for login command to bypass non-interactive login

Bug Fixes

• Fix automatic update of auth tokens for username/email with special characters

Confluent CLI v1.20.1 Release Notes

New Features

• Prompt for credentials instead of throwing error when non-interactive login fails

Confluent CLI v1.20.0 Release Notes

New Features

• Verbose HTTP and TLS information is logged (with trace log level) when logging in to the CLI.
• Non-interactive login supported via environment variables
• Binaries and archives are now shipped for Alpine Linux

Bug Fixes

• Fixed issue where update command may not detect new CLI versions

Confluent CLI v1.19.1 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.19.0 Release Notes

New Features

• Infer default protocol and port number for URLs when logging in

Bug Fixes

• When using local Kafka sub-commands, only check status of Kafka cluster if it is a locally-running cluster
• Fix flushing of logs and log processing during CLI startup

Confluent CLI v1.18.0 Release Notes

New Features

• Improve warning messages for audit log commands

Confluent CLI v1.17.0 Release Notes

New Features

• Expose context management commands

Bug Fixes

• Add additional logging when setting custom CA cert path
• Updated list of connectors for CP 6.0
• Fix KSQL path issue for CP verions older than 5.5
• Minor documentation/example fixes

Confluent CLI v1.16.0 Release Notes

New Features

• Add audit log migration commands
• Support piping credentials to login commands

Confluent CLI v1.15.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.14.0 Release Notes

No changes relating to Confluent CLI for this version.

Confluent CLI v1.13.1 Release Notes

Bug Fixes

• Fix command output bug for commands that were supposed to output to Stdout but were outputting to Stderr

Confluent CLI v1.13.0 Release Notes

New Features

• Allow for pipe-able log output from confluent local services ... log.

Bug Fixes

• Fix panic when invalid role is specified during resource-scoped rolebinding commands.
• Fix grammar and typos in command help and examples.

Confluent CLI v1.12.1 Release Notes

Bug Fixes

• Fix success and error message display bug

Confluent CLI v1.12.0 Release Notes

Bug Fixes

• Improve error message handling for audit log commands
• Fix parsing of credentials on Windows for login command

Confluent CLI v1.11.0 Release Notes

New Features

• Rewrite confluent local command to use consistent grammar and eliminate need for passing – to subcommands with arguments
• Add confluent cluster command to register/unregister clusters from a Confluent Cluster Registry instance (Confluent Platform 5.5+)
• Update RBAC rolebinding commands to support friendly cluster names
• Add Schema Registry ACLs commands for confluent local
• Improve error and success messages and add suggestions for commands that don’t succeed

Bug Fixes

• Update macOS system requirements for Confluent Platform 6.0
• Fix handling of errors from invalid RBAC rolebinding commands for Confluent Platform 6.0
• Handle errors with loading CLI configuration files and ignore them when configs aren’t needed
• Respect log output/verbosity levels when loading configuration files
• Only check for updates once every 24 hours

Confluent CLI v1.10.0 Release Notes

Bug Fixes

• Compatibility fix for RBAC in Confluent Platform 5.x

Confluent CLI v1.9.0 Release Notes

Bug Fixes

• Restrict feedback nudges to fewer commands
• Skip update check when running the update command

Confluent CLI v1.8.0 Release Notes

New Features

• Update RBAC rolebinding commands to support friendly cluster names (CP 6.0)
• Add feedback command so users can give direct in-product feeback
• Start publishing release notes with each release

Bug Fixes

• Fix panics when metadata service returns internal server errors
• Improve command examples in help output