Production considerations

Alpakka Kafka API

  1. Do not use Consumer.atMostOnceSource in production as it internally commits the offset after every element.
  2. If you create Producer sinks in “inner flows”, be sure to share the Producer instance. This avoids the expensive creation of KafkaProducer instances.

This is just a start, please add your experiences to this list by opening a Pull Request.


For performance monitoring consider Lightbend Telemetry which gives insights into Akka and Akka Streams.

Security setup

Configure the Kafka brokers as described in Confluent’s article “Configuring Kafka Clients”.

For Alpakka Kafka the client configuration parameters go in the akka.kafka.consumer.kafka-clients and akka.kafka.producer.kafka-clients sections of the configuration.

akka.kafka.producer {
  kafka-clients {

The truststore and keystore locations may specify URLs, absolute paths or relative paths (starting with ./).

You have the option to pass the passwords as command line parameters or environment values via the support in Config.

Found an error in this documentation? The source code for this page can be found here. Please feel free to edit and contribute a pull request.