KubeBlocks
BlogsEnterprise
⌘K
​
kbcli
kbcli addon
kbcli addon describe
kbcli addon disable
kbcli addon enable
kbcli addon index
kbcli addon index add
kbcli addon index delete
kbcli addon index list
kbcli addon index update
kbcli addon install
kbcli addon list
kbcli addon search
kbcli addon uninstall
kbcli addon upgrade
kbcli alert
kbcli alert add-receiver
kbcli alert config-smtpserver
kbcli alert delete-receiver
kbcli alert list-receivers
kbcli alert list-smtpserver
kbcli backuprepo
kbcli backuprepo create
kbcli backuprepo delete
kbcli backuprepo describe
kbcli backuprepo list
kbcli backuprepo update
kbcli bench
kbcli bench delete
kbcli bench describe
kbcli bench list
kbcli bench pgbench
kbcli bench redis-benchmark
kbcli bench sysbench
kbcli bench tpcc
kbcli bench tpcds
kbcli bench tpch
kbcli bench ycsb
kbcli cluster
kbcli cluster backup
kbcli cluster cancel-ops
kbcli cluster configure
kbcli cluster connect
kbcli cluster create-account
kbcli cluster create
kbcli cluster create elasticsearch
kbcli cluster create kafka
kbcli cluster create llm
kbcli cluster create mongodb
kbcli cluster create mysql
kbcli cluster create oriol
kbcli cluster create orioledb
kbcli cluster create postgresql
kbcli cluster create qdrant
kbcli cluster create redis
kbcli cluster create tidb
kbcli cluster create xinference
kbcli cluster custom-ops
kbcli cluster delete-account
kbcli cluster delete-backup
kbcli cluster delete-ops
kbcli cluster delete
kbcli cluster describe-account
kbcli cluster describe-backup-policy
kbcli cluster describe-backup
kbcli cluster describe-config
kbcli cluster describe-ops
kbcli cluster describe
kbcli cluster diff-config
kbcli cluster edit-backup-policy
kbcli cluster edit-config
kbcli cluster explain-config
kbcli cluster expose
kbcli cluster grant-role
kbcli cluster hscale
kbcli cluster label
kbcli cluster list-accounts
kbcli cluster list-backup-policy
kbcli cluster list-backups
kbcli cluster list-components
kbcli cluster list-events
kbcli cluster list-instances
kbcli cluster list-logs
kbcli cluster list-ops
kbcli cluster list
kbcli cluster logs
kbcli cluster promote
kbcli cluster rebuild-instance
kbcli cluster register
kbcli cluster restart
kbcli cluster restore
kbcli cluster revoke-role
kbcli cluster start
kbcli cluster stop
kbcli cluster update
kbcli cluster upgrade
kbcli cluster volume-expand
kbcli cluster vscale
kbcli clusterdefinition
kbcli clusterdefinition describe
kbcli clusterdefinition list-components
kbcli clusterdefinition list-service-reference
kbcli clusterdefinition list
kbcli clusterversion
kbcli clusterversion list
kbcli clusterversion set-default
kbcli clusterversion unset-default
kbcli dashboard
kbcli dashboard list
kbcli dashboard open
kbcli dataprotection
kbcli dataprotection backup
kbcli dataprotection delete-backup
kbcli dataprotection describe-backup-policy
kbcli dataprotection describe-backup
kbcli dataprotection list-backup-policy
kbcli dataprotection list-backups
kbcli dataprotection restore
kbcli kubeblocks
kbcli kubeblocks compare
kbcli kubeblocks config
kbcli kubeblocks describe-config
kbcli kubeblocks install
kbcli kubeblocks list-versions
kbcli kubeblocks preflight
kbcli kubeblocks status
kbcli kubeblocks uninstall
kbcli kubeblocks upgrade
kbcli options
kbcli playground
kbcli playground destroy
kbcli playground init
kbcli plugin
kbcli plugin describe
kbcli plugin index
kbcli plugin index add
kbcli plugin index delete
kbcli plugin index list
kbcli plugin index update
kbcli plugin install
kbcli plugin list
kbcli plugin search
kbcli plugin uninstall
kbcli plugin upgrade
kbcli report
kbcli report cluster
kbcli report kubeblocks
kbcli version
KubeBlocks CLI Overview
  1. addon
  2. backuprepo
  3. bench
  4. cluster
  5. clusterdefinition
  6. clusterversion
  7. dashboard
  8. dataprotection
  9. kubeblocks
  10. options
  11. playground
  12. plugin
  13. report
  14. version

addon

Addon command.

  • kbcli addon describe - Describe an addon specification.
  • kbcli addon disable - Disable an addon.
  • kbcli addon enable - Enable an addon.
  • kbcli addon index - Manage custom addon indexes
  • kbcli addon install - Install KubeBlocks addon
  • kbcli addon list - List addons.
  • kbcli addon search - Search the addon from index
  • kbcli addon uninstall - Uninstall an existed addon
  • kbcli addon upgrade - Upgrade an existed addon to latest version or a specified version

backuprepo

BackupRepo command.

  • kbcli backuprepo create - Create a backup repository
  • kbcli backuprepo delete - Delete a backup repository.
  • kbcli backuprepo describe - Describe a backup repository.
  • kbcli backuprepo list - List Backup Repositories.
  • kbcli backuprepo update - Update a backup repository.

bench

Run a benchmark.

  • kbcli bench delete - Delete a benchmark.
  • kbcli bench describe - Describe a benchmark.
  • kbcli bench list - List all benchmarks.
  • kbcli bench pgbench - Run pgbench against a PostgreSQL cluster
  • kbcli bench redis-benchmark - Run redis-benchmark on a cluster
  • kbcli bench sysbench - run a SysBench benchmark
  • kbcli bench tpcc - Run tpcc benchmark
  • kbcli bench tpcds - Run TPC-DS benchmark
  • kbcli bench tpch - Run tpch benchmark
  • kbcli bench ycsb - Run YCSB benchmark on a cluster

cluster

Cluster command.

  • kbcli cluster backup - Create a backup for the cluster.
  • kbcli cluster cancel-ops - Cancel the pending/creating/running OpsRequest which type is vscale or hscale.
  • kbcli cluster configure - Configure parameters with the specified components in the cluster.
  • kbcli cluster connect - Connect to a cluster or instance.
  • kbcli cluster create - Create a cluster.
  • kbcli cluster create-account - Create account for a cluster
  • kbcli cluster custom-ops -
  • kbcli cluster delete - Delete clusters.
  • kbcli cluster delete-account - Delete account for a cluster
  • kbcli cluster delete-backup - Delete a backup.
  • kbcli cluster delete-ops - Delete an OpsRequest.
  • kbcli cluster describe - Show details of a specific cluster.
  • kbcli cluster describe-account - Describe account roles and related information
  • kbcli cluster describe-backup - Describe a backup.
  • kbcli cluster describe-backup-policy - Describe backup policy
  • kbcli cluster describe-config - Show details of a specific reconfiguring.
  • kbcli cluster describe-ops - Show details of a specific OpsRequest.
  • kbcli cluster diff-config - Show the difference in parameters between the two submitted OpsRequest.
  • kbcli cluster edit-backup-policy - Edit backup policy
  • kbcli cluster edit-config - Edit the config file of the component.
  • kbcli cluster explain-config - List the constraint for supported configuration params.
  • kbcli cluster expose - Expose a cluster with a new endpoint, the new endpoint can be found by executing 'kbcli cluster describe NAME'.
  • kbcli cluster grant-role - Grant role to account
  • kbcli cluster hscale - Horizontally scale the specified components in the cluster.
  • kbcli cluster label - Update the labels on cluster
  • kbcli cluster list - List clusters.
  • kbcli cluster list-accounts - List accounts for a cluster
  • kbcli cluster list-backup-policy - List backups policies.
  • kbcli cluster list-backups - List backups.
  • kbcli cluster list-components - List cluster components.
  • kbcli cluster list-events - List cluster events.
  • kbcli cluster list-instances - List cluster instances.
  • kbcli cluster list-logs - List supported log files in cluster.
  • kbcli cluster list-ops - List all opsRequests.
  • kbcli cluster logs - Access cluster log file.
  • kbcli cluster promote - Promote a non-primary or non-leader instance as the new primary or leader of the cluster
  • kbcli cluster rebuild-instance - Rebuild the specified instances in the cluster.
  • kbcli cluster register - Pull the cluster chart to the local cache and register the type to 'create' sub-command
  • kbcli cluster restart - Restart the specified components in the cluster.
  • kbcli cluster restore - Restore a new cluster from backup.
  • kbcli cluster revoke-role - Revoke role from account
  • kbcli cluster start - Start the cluster if cluster is stopped.
  • kbcli cluster stop - Stop the cluster and release all the pods of the cluster.
  • kbcli cluster update - Update the cluster settings, such as enable or disable monitor or log.
  • kbcli cluster upgrade - Upgrade the cluster version.
  • kbcli cluster volume-expand - Expand volume with the specified components and volumeClaimTemplates in the cluster.
  • kbcli cluster vscale - Vertically scale the specified components in the cluster.

clusterdefinition

ClusterDefinition command.

  • kbcli clusterdefinition describe - Describe ClusterDefinition.
  • kbcli clusterdefinition list - List ClusterDefinitions.
  • kbcli clusterdefinition list-components - List cluster definition components.
  • kbcli clusterdefinition list-service-reference - List cluster references declared in a cluster definition.

clusterversion

ClusterVersion command.

  • kbcli clusterversion list - List ClusterVersions.
  • kbcli clusterversion set-default - Set the clusterversion to the default clusterversion for its clusterdefinition.
  • kbcli clusterversion unset-default - Unset the clusterversion if it's default.

dashboard

List and open the KubeBlocks dashboards.

  • kbcli dashboard list - List all dashboards.
  • kbcli dashboard open - Open one dashboard.

dataprotection

Data protection command.

  • kbcli dataprotection backup - Create a backup for the cluster.
  • kbcli dataprotection delete-backup - Delete a backup.
  • kbcli dataprotection describe-backup - Describe a backup
  • kbcli dataprotection describe-backup-policy - Describe a backup policy
  • kbcli dataprotection list-backup-policy - List backup policies
  • kbcli dataprotection list-backups - List backups.
  • kbcli dataprotection restore - Restore a new cluster from backup

kubeblocks

KubeBlocks operation commands.

  • kbcli kubeblocks compare - List the changes between two different version KubeBlocks.
  • kbcli kubeblocks config - KubeBlocks config.
  • kbcli kubeblocks describe-config - Describe KubeBlocks config.
  • kbcli kubeblocks install - Install KubeBlocks.
  • kbcli kubeblocks list-versions - List KubeBlocks versions.
  • kbcli kubeblocks preflight - Run and retrieve preflight checks for KubeBlocks.
  • kbcli kubeblocks status - Show list of resource KubeBlocks uses or owns.
  • kbcli kubeblocks uninstall - Uninstall KubeBlocks.
  • kbcli kubeblocks upgrade - Upgrade KubeBlocks.

options

Print the list of flags inherited by all commands.

playground

Bootstrap or destroy a playground KubeBlocks in local host or cloud.

  • kbcli playground destroy - Destroy the playground KubeBlocks and kubernetes cluster.
  • kbcli playground init - Bootstrap a kubernetes cluster and install KubeBlocks for playground.

plugin

Provides utilities for interacting with plugins.

Plugins provide extended functionality that is not part of the major command-line distribution.

  • kbcli plugin describe - Describe a plugin
  • kbcli plugin index - Manage custom plugin indexes
  • kbcli plugin install - Install kbcli or kubectl plugins
  • kbcli plugin list - List all visible plugin executables on a user's PATH
  • kbcli plugin search - Search kbcli or kubectl plugins
  • kbcli plugin uninstall - Uninstall kbcli or kubectl plugins
  • kbcli plugin upgrade - Upgrade kbcli or kubectl plugins

report

Report kubeblocks or cluster info.

  • kbcli report cluster - Report Cluster information
  • kbcli report kubeblocks - Report KubeBlocks information, including deployments, events, logs, etc.

version

Print the version information, include kubernetes, KubeBlocks and kbcli version.

© 2026 KUBEBLOCKS INC