# Getting Started with WaterDrop

!!! info

    If you want to both produce and consume messages, please use [Karafka](https://karafka.io/docs/Getting-Started.md). It integrates WaterDrop automatically.

To get started with WaterDrop:

1. Add it to your Gemfile:

    ```shell
    bundle add waterdrop
    ```

1. Create and configure a producer:

    ```ruby
    producer = WaterDrop::Producer.new do |config|
      config.deliver = true
      config.kafka = {
        'bootstrap.servers': 'localhost:9092',
        'request.required.acks': 1
      }
    end
    ```

1. Use it as follows:

    ```ruby
    # And use it
    producer.produce_sync(topic: 'my-topic', payload: 'my message')

    # or for async
    producer.produce_async(topic: 'my-topic', payload: 'my message')

    # or in batches
    producer.produce_many_sync(
      [
        { topic: 'my-topic', payload: 'my message'},
        { topic: 'my-topic', payload: 'my message'}
      ]
    )

    # both sync and async
    producer.produce_many_async(
      [
        { topic: 'my-topic', payload: 'my message'},
        { topic: 'my-topic', payload: 'my message'}
      ]
    )
    ```

!!! info

    For additional WaterDrop usage examples, please refer to the [Usage](https://karafka.io/docs/WaterDrop-Usage.md) section of this documentation.

---

## Getting Started with WaterDrop / See Also

- [WaterDrop About](https://karafka.io/docs/WaterDrop-About.md) - Introduction and overview of WaterDrop producer
- [WaterDrop Usage](https://karafka.io/docs/WaterDrop-Usage.md) - Detailed usage patterns and examples
- [Producing Messages](https://karafka.io/docs/Producing-Messages.md) - Complete guide to producing messages with Karafka
- [WaterDrop Configuration](https://karafka.io/docs/WaterDrop-Configuration.md) - Comprehensive configuration options for WaterDrop


---

*Last modified: 2025-11-03 14:04:02*