Install or Upgrade from a Prebuilt Binary

You can choose between two types of prebuilt binaries:

  • Standard binary: Suitable for most users. Does not require cgo. Does not include the TigerBeetle CDC input connector.

  • cgo-enabled binary: Required only if you need the TigerBeetle CDC input connector. Only available for Linux AMD64.

Install a prebuilt binary

  1. Ensure you have wget and tar installed.

  2. Download the desired Redpanda Connect binary for your platform. You can find a complete list of releases on the GitHub releases page.

    Binary type Example download command

    Standard (no cgo, most users)

    wget https://github.com/redpanda-data/redpanda-connect/releases/download/v4.65.0/redpanda-connect_4.65.0_linux_amd64.tar.gz

    cgo-enabled (TigerBeetle CDC support)

    wget https://github.com/redpanda-data/redpanda-connect/releases/download/v4.65.0/redpanda-connect-cgo_4.65.0_linux_amd64.tar.gz
  3. Extract the binary from the archive (replace the filename as needed):

    tar -xzf <filename>.tar.gz
  4. Move the binary to a directory in your PATH (for example, /usr/local/bin):

    sudo mv redpanda-connect /usr/local/bin/
  5. Verify the installation:

    redpanda-connect --version

You should see a version number.

Upgrade a prebuilt binary

To upgrade, repeat the installation steps with the new version. Stop any running Redpanda Connect processes, download and extract the new binary, replace the old binary, and verify the upgrade.

After upgrading (or downgrading), you must restart a pipeline to use features in the Redpanda Connect version you have deployed.

Uninstall

To uninstall Redpanda Connect, remove the installed binary:

sudo rm /usr/local/bin/redpanda-connect

This removes the Redpanda Connect binary from your system.

Next steps

Explore the available connectors in the catalog.