Install Confluent Cloud CLI

This topic describes how to perform a fresh install of Confluent Cloud CLI.

If you already have an older version of Confluent Cloud CLI installed, use the ccloud update command to upgrade to a newer version of Confluent Cloud.

Important

If you are using version 1.21, 1.22, or 1.23 of Confluent Cloud CLI, you must upgrade to a version 1.25 or newer, using the ccloud update command, to avoid a potential security vulnerability discovered in those versions.

Supported environments

The Confluent Cloud CLI is supported for macOS, Microsoft Windows, and Linux (including Alpine) operating systems.

Scripted installation

Note

On Microsoft Windows, an appropriate Linux environment may need to be installed in order to have the curl and sh commands available, such as the Windows Subsystem for Linux.

  1. List all available Confluent Cloud CLI versions:

    curl -sL --http1.1 https://cnfl.io/ccloud-cli | sh -s -- -l
    
  2. Download a specific version, <version>, listed in the above output to the <path-to-cli> directory:

    curl -sL --http1.1 https://cnfl.io/ccloud-cli | sh -s -- <version> -b <path-to-cli>
    

    The script detects which system is running and downloads the appropriate binary.

    Important

    You must have access to the <path-to-cli> installation directory. If you get an “access denied” error, try installing into ~/local/bin.

  3. Add the CLI installation location to your PATH environment variable.

    export PATH=<path-to-cli>:$PATH;
    
  4. Connect to a Confluent Cloud cluster.

Tarball or Zip installation

  1. Download and install the most recently released CLI binaries by platform:
  2. Set the PATH environment to include the directory that you downloaded the CLI binaries in the previous step.
  3. Connect to a Confluent Cloud cluster.

Verify

  1. Verify installation by typing ccloud in your terminal.

    ccloud
    

    You should see Confluent Cloud CLI usage information:

    Welcome to the Confluent Cloud CLI
    
    Usage:
      ccloud [command]
    
    Available Commands:
      api-key         Manage API keys
      completion      Output shell completion code
      environment     Manage and select ccloud environments
      help            Help about any command
      kafka           Manage Kafka
      login           Login to Confluent Cloud
      logout          Logout of Confluent Cloud
      service-account Manage service accounts
      update          Update ccloud
      version         Print the ccloud version
    
    Flags:
      -h, --help            help for ccloud
      -v, --verbose count   increase output verbosity
          --version         version for ccloud
    
  2. Log in to your Confluent Cloud cluster using the following command:

    ccloud login
    
  3. View your cluster using the following command:

    ccloud kafka cluster list
    

    Your output should resemble:

          Id      |       Name        | Provider |   Region    | Durability | Status
    +-------------+-------------------+----------+-------------+------------+--------+
        lkc-emmox | My first cluster  | gcp      | us-central1 | LOW        | UP
        lkc-low0y | My second cluster | gcp      | us-central1 | LOW        | UP
    
  4. Designate the active cluster using the following command. The command requires the cluster ID as an argument, not the user defined name:

    ccloud kafka cluster use lkc-emmox
    

Uninstall

Run these commands to uninstall the Confluent Cloud CLI. These commands assume you have installed the CLI in the /usr/local/bin folder. Replace /usr/local/bin with the location of your own <path-to-cli> if the CLI is installed in another directory:

rm -rf ~/.ccloud/

sudo rm /usr/local/bin/ccloud

Uninstall CLI Versions Prior to 0.78.x

You can uninstall versions of the Confluent Cloud CLI prior to 0.78.x with these instructions. You can check the version of the Confluent Cloud CLI with the ccloud version command.

Tip

Confluent Cloud CLI versions prior to 0.78.x stored their configuration in .ccloud/config. This file is no longer used and can be deleted. For more information, see Login and Configuration.

MacOS

Run this command from your terminal:

brew uninstall ccloud

Linux

  1. Delete the Confluent Cloud CLI files and folder from your system. For example:

    rm -rf <path-to-ccloud-cli>/ccloud-0.2.1
    
  2. Remove the entry from your PATH environment variable.

Windows

  1. Delete the Confluent Cloud CLI files and folder from your system. For example:

    rm -rf <path-to-ccloud-cli>/ccloud-0.2.1
    
  2. Remove the entry from your JAVA_HOME environment variable.