Build or Upgrade from Source

You can build Redpanda Connect in two ways:

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

  • cgo-enabled build: Required only if you need the TigerBeetle CDC input connector.

Install from source

  1. Ensure you have Go installed on your system. You can download it from the official Go website.

  2. Clone the Redpanda Connect repository:

    git clone https://github.com/redpanda-data/connect.git
    cd connect
  3. Build the binary (choose one):

    Build type Build command

    Standard (no cgo, most users)

    go build -o redpanda-connect ./cmd/redpanda-connect

    cgo-enabled (TigerBeetle CDC support)

    CGO_ENABLED=1 go build -o redpanda-connect ./cmd/redpanda-connect
  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.

Upgrade a source build

  1. Navigate to your existing clone of the repository:

    cd connect
  2. Fetch the latest tags and check out the version you want:

    git fetch --all
    git checkout v4.65.0
  3. Rebuild the binary (choose one):

    Build type Build command

    Standard (no cgo, most users)

    go build -o redpanda-connect ./cmd/redpanda-connect

    cgo-enabled (TigerBeetle CDC support)

    CGO_ENABLED=1 go build -o redpanda-connect ./cmd/redpanda-connect
  4. Replace the previous binary and verify:

    sudo mv redpanda-connect /usr/local/bin/
    redpanda-connect --version
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.