Connect

Install or Upgrade from a Prebuilt Binary

You can choose between two types of prebuilt binaries:

  • Standard binary: Suitable for most users. Built with cgo disabled, and available for Linux, macOS, and Windows on AMD64 and ARM64. Leaves out the components that need cgo.

  • cgo-enabled binary: Required only for the components listed below. Available for Linux AMD64 only. The machine that runs it needs the ZeroMQ shared library (libzmq), because the binary links to it dynamically.

These components are available only in the cgo-enabled binary:

Each component’s reference page also notes when the component needs cgo.

Install a prebuilt binary

  1. Ensure you have wget and tar installed.

  2. Download the desired Redpanda Connect archive for your platform. The examples download the Linux AMD64 archives. For other platforms, replace linux_amd64 with darwin_amd64, darwin_arm64, linux_arm64, windows_amd64, or windows_arm64. 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/connect/releases/download/v4.113.0/redpanda-connect_4.113.0_linux_amd64.tar.gz

    cgo-enabled (adds the components that need cgo)

    		 
    wget https://github.com/redpanda-data/connect/releases/download/v4.113.0/redpanda-connect-cgo_4.113.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.