Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

kafka connectors

The config fields of a kafka connector, which backs Kafka topics, produce only.

Produces to Kafka topics through publish_kafka. The connector is producer-only: consuming is configured under [kafka] in the server config, not here.

{
  "name": "event-bus",
  "connector_type": "kafka",
  "config": {
    "type": "kafka",
    "brokers": ["kafka1:9092", "kafka2:9092"],
    "topic": "events"
  }
}
FieldTypeRequiredDefaultDescription
brokersarray of stringsyesBare host:port entries, no URL scheme. An empty list [] publishes through the globally configured [kafka] cluster
topicstringyesThe topic this connector is associated with. Each publish_kafka task names its own target topic
allow_private_urlsbooleannofalseAllow brokers on private and internal IP addresses; entries are checked as host/port pairs (SSRF protection)
operationsobjectnoall allowedpublish gate — see Operation gates

Note

publish_kafka requires kafka.enabled = true in the server config, even when the connector names its own brokers.

Last verified 14 September 2026