Confluent Hub Client

The Confluent Hub client is a command line tool that makes it easy to install and update components from Confluent Hub into a local Confluent Platform installation.

Installing Confluent Hub Client

The Confluent Hub client is natively installed as a part of Confluent Platform and located in the /bin directory. You can also install separately by following these instructions.

MacOS

  1. Tap the Confluent repository for the Confluent Hub client.

    brew tap confluentinc/homebrew-confluent-hub-client
    
  2. Install the Confluent Hub client.

    brew cask install confluent-hub-client
    
  3. Optional: Verify your installation by typing confluent-hub in your terminal.

    confluent-hub
    

    Your output should look like this:

    usage: confluent-hub <command> [ <args> ]
    
    Commands are:
        help      Display help information
        install   install a component from either Confluent Hub or from a local file
    
    See 'confluent-hub help <command>' for more information on a specific command.
    

Linux

Download and unzip the Confluent Hub tarball.

  1. Download and unzip confluent-hub-client-latest.tar.gz. Add the contents of the bin directory to your PATH environment variable so that which ccloud finds the confluent-hub command.

  2. Optional: Verify your installation by typing confluent-hub in your terminal.

    confluent-hub
    

    Your output should look like this:

    usage: confluent-hub <command> [ <args> ]
    
    Commands are:
        help      Display help information
        install   install a component from either Confluent Hub or from a local file
    
    See 'confluent-hub help <command>' for more information on a specific command.
    

Installing Components With Confluent Hub Client

You can click the Installation tab of a component on Confluent Hub to get the component-specific installation commands or see the connector installation documentation. For example, here are the installation instructions for the Kafka Connect JDBC connector:

../../../_images/confluent-hub-1.png

Use this Confluent Hub client command to install components from Confluent Hub into a local Confluent Platform installation:

confluent-hub install <owner>/<component>:<version>

where

  • <owner> is the name of component owner on Confluent Hub.
  • <component> is the name of the component on Confluent Hub.
  • <version> is either the version of the component on Confluent Hub or the literal latest when you just want to install the latest version of the component.

Tip

If the Installation tab doesn't provide the Confluent Hub installation command, contact the component owner.