> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streemlined.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connector Plugins

> Extend Streemlined with additional Kafka Connect connectors

<Info>
  Streemlined does not pre-package connectors that require users to accept a specific license agreement. If you need such connectors, you must first accept the license from the provider, then mount the plugin JARs yourself.
</Info>

Streemlined is built on top of Kafka Connect, which means you can extend it with any compatible connector plugin. This guide explains how to add custom connectors to your Streemlined deployment.

## Pre-packaged Connectors

The default Streemlined image includes the following Sink Connectors:

| Connector                                                                                  | License    |
| ------------------------------------------------------------------------------------------ | ---------- |
| [Aiven JDBC Sink Connector](https://github.com/Aiven-Open/jdbc-connector-for-apache-kafka) | Apache 2.0 |
| [Aiven HTTP Sink Connector](https://github.com/Aiven-Open/http-connector-for-apache-kafka) | Apache 2.0 |

## Adding Custom Connectors

To add additional Kafka Connect connectors, you need to mount the connector JARs into the Streemlined container.

### Step 1: Download Connector JARs

Download the connector plugin(s) you want to add. Connectors are typically distributed as:

* A single JAR file
* A ZIP archive containing the JAR and its dependencies
* A directory with multiple JARs

### Step 2: Mount the Plugins

You have two options for mounting connector plugins:

* **Override all connectors** — Mount a directory to `/home/app/plugins` to completely replace the pre-packaged connectors with your own set
* **Add more connectors** — Mount individual connector directories inside the plugins folder (e.g., `/home/app/plugins/mongo`) to keep the pre-packaged connectors and add new ones

<Tabs>
  <Tab title="Docker Compose">
    **Override all connectors:**

    ```yaml docker-compose.yml theme={null}
    services:
      streemlined:
        image: streemlined/streemlined:latest
        ports:
          - "8080:8080"
        volumes:
          - ./application.yml:/home/app/application.yml
          - ./plugins:/home/app/plugins
    ```

    **Add connectors while keeping pre-packaged ones:**

    ```yaml docker-compose.yml theme={null}
    services:
      streemlined:
        image: streemlined/streemlined:latest
        ports:
          - "8080:8080"
        volumes:
          - ./application.yml:/home/app/application.yml
          - ./mongo-connector:/home/app/plugins/mongo
          - ./s3-connector:/home/app/plugins/s3
    ```
  </Tab>

  <Tab title="Docker">
    **Override all connectors:**

    ```bash command theme={null}
    docker run -p 8080:8080 \
      -v ./application.yml:/home/app/application.yml \
      -v ./plugins:/home/app/plugins \
      streemlined/streemlined:latest
    ```

    **Add connectors while keeping pre-packaged ones:**

    ```bash command theme={null}
    docker run -p 8080:8080 \
      -v ./application.yml:/home/app/application.yml \
      -v ./mongo-connector:/home/app/plugins/mongo \
      -v ./s3-connector:/home/app/plugins/s3 \
      streemlined/streemlined:latest
    ```
  </Tab>
</Tabs>

### Step 3: Organize Your Plugins Directory

Structure your plugins directory with each connector in its own subdirectory:

```
plugins/
├── elasticsearch-connector/
│   ├── kafka-connect-elasticsearch-14.0.0.jar
│   └── ... (dependency JARs)
├── s3-connector/
│   ├── kafka-connect-s3-10.5.0.jar
│   └── ... (dependency JARs)
└── mongodb-connector/
    ├── mongo-kafka-connect-1.11.0.jar
    └── ... (dependency JARs)
```

## Popular Connector Sources

Here are some popular sources for Kafka Connect connectors:

<CardGroup cols={2}>
  <Card title="Confluent Hub" icon="puzzle-piece" href="https://www.confluent.io/hub/">
    Browse hundreds of connectors from Confluent and the community
  </Card>

  <Card title="Aiven Open Source" icon="github" href="https://github.com/Aiven-Open">
    Open source connectors maintained by Aiven
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Configuration" icon="gear" href="/configuration">
    Configure your Kafka clusters and databases
  </Card>

  <Card title="Nodes Reference" icon="diagram-project" href="/nodes">
    Learn about available pipeline nodes
  </Card>
</CardGroup>