Kafka Default Config Reference

Every Kafka default for a release you choose, as a table. Filter by name or importance, or ask only for the defaults that changed from the previous release, which is the list worth reading before an upgrade.

Importance

All 16 releases from 2.5 to 4.1, from the tables Kafka's own ConfigDef generates. The box below filters by name: leave it empty for every setting, or type something like replica or ssl. to narrow it.

Paste below, or drop a file anywhere on this panel

Or drop a file anywhere on this panel. Nothing is uploaded: the analysis runs in this tab.

The answer appears here

Paste on the left and press Show defaults. Nothing leaves this tab.

Common mistakes

These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.

  1. Reading a default without checking the version

    Defaults move between releases, and a setting you never edited can change behaviour on upgrade. That is the most common source of surprise after an upgrade.

    Instead:Select your version. The whole dataset is versioned for this reason.

  2. Assuming an unset config equals the documented default

    A broker command line argument or a dynamic config can override it while the file says nothing.

    Instead:Check kafka-configs --describe for what is actually in effect.

  3. Copying a default into your config file to be explicit

    It pins the value across future upgrades, so an improved default never reaches you and the pin is invisible in review.

    Instead:Leave defaults unset unless you are deliberately overriding them.

The defaults that changed under configs nobody edited

A changed default only affects the configs that never set the value, which is exactly why it goes unnoticed: your file did not change and the behaviour did.

This is the list to diff against before an upgrade

Tick changed only and the table becomes every default that moved between the release before your selection and your selection. Kafka 3.0 is the big one: enable.idempotence went false to true, which took acks from 1 to all, and the consumer session.timeout.ms went from 10 seconds to 45. Kafka 4.0 moved the producer linger.ms from 0 to 5 milliseconds, which changes the latency profile of every producer that never mentioned it. None of that appears in a diff of your own config.

Importance is Kafka's own ranking, not ours

Every setting carries a high, medium or low importance in ConfigDef, and it is the field the official tables sort by. Filtering to high gives the settings Kafka itself considers worth understanding before running in production, which for the broker is a couple of dozen rather than several hundred. It is a reasonable reading order for someone new to a config kind.

The reading beside a number is Kafka's, and it is stored separately

Kafka's documentation prints 604800000 (7 days) for a duration default. Those two facts are stored apart here, and shown on separate lines, for a specific reason: a config file saying 604800000 has to compare equal to its default, and leaving the words in the value made 110 settings look like they changed default in 2.6 when only the documentation had.

Absent is not the same as defaulted

A setting only appears in the table for a version it actually exists in. Kafka 4.0 is KRaft only, so every ZooKeeper setting is missing from it rather than present with a default, and a table that filled those in from an older release would be inventing values. Where a default is genuinely unset in ConfigDef, the row says none rather than guessing at what the code does.

What this cannot see

Only the seven kinds Kafka publishes ConfigDef tables for. Nothing from interceptors, metrics reporters, Connect plugins or a vendor distribution is in the source, so those settings are absent rather than wrong. It also cannot tell you whether a changed default matters for your workload, only that it changed; for that, the config upgrade checker on this site reads your actual file against two releases.

More kafka tools

Kafka Confluent Wire Format Decoder The five junk bytes in front of your payload Kafka Key to Partition Mapper Which partition does this key land on? Kafka Topic Name Validator Legal, risky, or 249 characters too long? Kafka Replication Safety Checker How many brokers can you lose Kafka Producer Config Linter Will it start, and will it lose a record? Kafka Message Payload Decoder The first five bytes are usually not data Kafka Connect Source Connector Generator tasks.max is a ceiling, not a count Kafka Connect Sink Connector Generator A dead letter queue with no context headers is a pile of records Kafka Connect SMT Chain Builder The order is the transforms list Kafka MirrorMaker 2 Config Generator It renames every topic by default Kafka Partition Reassignment Generator The throttle is not optional Strimzi Kafka Resource Generator Without the cluster label, nothing happens Kafka mTLS Config Generator The certificate is the identity Kafka Schema Registry Config Generator The compatibility direction is your deployment order Kafka Exactly-Once Config Generator Half of it is worse than none Kafka Broker and KRaft Config Generator The internal topics that break a one-broker cluster Kafka Quota Generator Byte rates are per broker, not per cluster Kafka Streams Config Generator application.id is four things at once Kafka Connect Worker Config Generator Security three times, or the tasks fail Kafka Retention and Unit Converter log.retention.hours does not take milliseconds Kafka Timestamp Converter Two sentinels and two meanings Kafka .properties to YAML Converter Dotted keys stay flat Kafka Streams Internal Topic Predictor Create them before Streams does Kafka ACL Generator The grant you forgot is on another resource type Kafka Topic Config Generator min.insync.replicas is the one that matters Kafka client.properties Generator The file every CLI tool asks for Kafka Producer Config Generator No password field, on purpose Kafka Consumer Config Generator The commit mode decides the semantics Kafka Disk and Retention Calculator retention.bytes is per partition Kafka Partition Count Calculator The number you can never reduce Kafka Cluster Sizing Calculator The traffic no client metric shows Kafka Consumer Lag Catch-Up Calculator Whether it ever clears, not just when Kafka Producer Batching Calculator linger.ms=0 still batches Kafka Segment and Index Sizing Why retention.ms is a lower bound Kafka Rebalance Duration Estimator What a rolling restart really costs Kafka Cost Estimator Your rates, so nothing goes stale Kafka Config Explorer by Version The answer depends on the release Kafka OAuth Bearer Token Decoder Will Kafka accept it, and can it refresh Kafka Record Header Viewer Headers are a list, not a map Kafka Topic Regex Subscription Tester Kafka matches the whole name Kafka ACL Permission Matrix Viewer DENY beats every ALLOW Kafka Connect Config Validator The mistakes that raise no error Kafka Consumer Group Id Validator Which broker coordinates the group Kafka Partition Assignment Visualizer Leadership is the load, not replicas Kafka Consumer Assignment Visualizer The three assignors disagree Kafka ZooKeeper to KRaft Config Converter The authorizer class nobody changes Kafka Config to Strimzi Half of it belongs elsewhere Kafka Docker Compose Generator (KRaft) Reachable from inside and outside Kafka JAAS Config Decoder The line that stops SASL working Kafka CRC32C Calculator Which CRC, over which bytes Kafka Config Upgrade Checker What breaks when you upgrade Kafka Kafka Config Diff Which change actually changed something Kafka Consumer Config Linter Why the group rebalances, and where the records went Kafka Avro Schema Validator The defaults Avro accepts and rejects Kafka Schema Compatibility Checker What the registry will say, before you ask it Kafka Avro Schema Diff Which direction each change breaks Kafka Compression Comparison Measured on your bytes Kafka Delivery Semantics Exactly-once has a consumer half Kafka ksqlDB Query Builder It looks like SQL and the rules are not Kafka Connect SMT Predicate Tester negate reads backwards Kafka Streams Topology Viewer Count the repartitions Kafka Connect Pipeline Visualizer The order things really run in Kafka Protobuf Binary Decoder Works without the .proto Kafka Protobuf JSON Converter Why your JSON does not round-trip Kafka Protobuf to Avro Schema What does not survive the conversion Kafka Avro Binary Decoder Wrong schema, no error Kafka Avro JSON Converter Why the console producer rejects your line Kafka Avro Sample Data Generator Records that actually serialize Kafka JSON to Avro Schema What JSON cannot tell you Kafka JSON Schema to Avro What does not survive the conversion Kafka SASL JAAS Generator One login module, four syntaxes Kafka CLI Command Builder kcat is librdkafka, not Kafka

Elsewhere on the site