Advanced Configuration
This is a complete reference for the configuration values available.
# organization and cluster_id help Vectorized identify your system.
organization: ""
cluster_id: ""
rpk:
# TLS configuration to allow rpk to make requests to the redpanda API.
tls:
# The path to the root CA certificate (PEM).
truststore_file: ""
# The path to the client certificate (PEM). Only required if client authentication is
# enabled in the broker.
cert_file: ""
# The path to the client certificate key (PEM). Only required if client authentication is
# enabled in the broker.
key_file: ""
# Available tuners. Set to true to enable, false to disable.
# Setup NIC IRQs affinity, sets up NIC RPS and RFS, sets up NIC XPS, increases socket
# listen backlog, increases the number of remembered connection requests, bans the
# IRQ Balance service from moving distributed IRQs.
# Default: false
tune_network: false
# Sets the preferred I/O scheduler for given block devices.
# It can work using both the device name or a directory, in which the device where
# directory is stored will be optimized. Sets either 'none' or 'noop' scheduler
# if supported.
# Default: false
tune_disk_scheduler: false
# Disables IOPS merging.
# Default: false
tune_disk_nomerges: false
# Distributes IRQs across cores with the method deemed the most appropriate for the
# current device type (i.e. NVMe).
# Default: false
tune_disk_irq: false
# Installs a systemd service to run fstrim weekly, or starts the default fstrim service
# which comes with most Linux distributions.
# Default: false
tune_fstrim: false
# Disables hyper-threading, sets the ACPI-cpufreq governor to 'performance'. Additionaly
# if system reboot is allowed: disables Intel P-States, disables Intel C-States,
# disables Turbo Boost.
# Default: false
tune_cpu: true
# Increases the number of allowed asynchronous IO events.
# Default: false
tune_aio_events: false
# Syncs NTP.
# Default: false
tune_clocksource: true
# Tunes the kernel to prefer keeping processes in-memory instead of swapping them out.
# Default: false
tune_swappiness: false
# Enables transparent hugepages (THP) to reduce TLB misses.
# Default: false
tune_transparent_hugepages: false
# Enables memory locking.
# Default: false
enable_memory_locking: false
# Installs a custom script to process coredumps and save them to the given directory.
# Default: false
tune_coredump: false
# The directory where all coredumps will be saved after they're processed.
# Default: ''
coredump_dir: "/var/lib/redpanda/coredump"
# (Optional) The vendor, VM type and storage device type that redpanda will run on, in
# the format <vendor>:<vm>:<storage>. This hints to rpk which configuration values it
# should use for the redpanda IO scheduler.
# Default: ''
well_known_io: "aws:i3.xlarge:default"
redpanda:
# Path where redpanda will keep the data.
# Required.
data_directory: "var/lib/redpanda/data"
# Unique id identifying the node in the cluster.
# Required.
node_id: 1
# Skips most of the checks performed at startup, not recomended for production use.
# Default: false
developer_mode: false
# The log segment size in bytes.
# Default: 1GiB
log_segment_size: 1073742000
# The compacted log segment size in bytes.
# Default: 256MiB
compacted_log_segment_size: 268435500
# The IP address and port for the internal RPC server.
# Default: 127.0.0.0:33145
rpc_server:
address: "0.0.0.0"
port: 33145
# IP and port to listen for Kafka API requests.
# Default: 127.0.0.1:9092
kafka_api:
address: "0.0.0.0"
port: 33145
# TLS configuration for the RPC server.
# Default: null
rpc_server_tls:
# Whether to enable TLS for the RPC server.
enabled: false
# Require client authentication
require_client_auth: false
# The path to the server certificate PEM file.
cert_file: ""
# The path to the server key PEM file
key_file: ""
# The path to the truststore PEM file. Only required if client authentication
# is enabled.
truststore_file: ""
# TLS configuration for the Kafka API.
# Default: null
kafka_api_tls:
# Whether to enable TLS for the Kafka API.
enabled: false
# Require client authentication
require_client_auth: false
# The path to the server certificate PEM file.
cert_file: ""
# The path to the server key PEM file
key_file: ""
# The path to the truststore PEM file. Only required if client authentication
# is enabled.
truststore_file: ""
# Address and port of admin server.
# Default: 127.0.0.1:9644
admin:
address: "0.0.0.0"
port: 9644
# Address of RPC endpoint published to other cluster members.
# Default: 0.0.0.0:33145
advertised_rpc_api:
address: "0.0.0.0"
port: 33145
# Address of Kafka API published to the clients.
# Default: 0.0.0.0:9092
advertised_kafka_api:
address: "0.0.0.0"
port: 9092
# List of the seed servers used to join current cluster. If the seed_server list is
# empty the node will be a cluster root and it will form a new cluster
# Default: []
seed_servers:
- id: 0
host:
address: "192.167.32.78"
port: 33145
# Number of partitions for the internal raft metadata topic.
# Default: 7
seed_server_meta_topic_partitions: 7
# The raft leader heartbeat interval in milliseconds.
# Default: 150
raft_heartbeat_interval_ms: 150
# Minimum redpanda version
min_version: 0
# Maximum redpanda version
max_version: 1
# TLS configuration for Kafka API endpoint.
# Default: null
kafka_api_tls:
key_file: "path/to/key"
cert_file: "path/to/cert"
# Manage CPU scheduling.
# Default: false
use_scheduling_groups: false
# Enable the admin API.
# Default: true
enable_admin_api: true
# Admin API doc directory.
# Default: /usr/share/redpanda/admin-api-doc
admin_api_doc_dir: "/usr/share/redpanda/admin-api-doc"
# Default number of quota tracking windows.
# Default: 10
default_num_windows: 10
# Default quota tracking window size in milliseconds.
# Default: 1s
default_window_sec: 1000
# Quota manager garbage collection frequency in milliseconds.
# Default: 30s
quota_manager_gc_sec: 30000
# Target quota byte rate (bytes per second).
# Default: 64MiB
target_quota_byte_rate: 6291456
# Rack identifier.
# Default: null
rack: "rack-id"
# Disable registering metrics.
# Default: false
disable_metrics: false
# The minimum allowed session timeout for registered consumers. Shorter timeouts result
# in quicker failure detection at the cost of more frequent consumer heartbeating, which
# can overwhelm broker resources.
# Default: 6s
group_min_session_timeout_ms: 6000
# The maximum allowed session timeout for registered consumers. Longer timeouts give
# consumers more time to process messages in between heartbeats at the cost of a longer
# time to detect failures.
# Default: 30s
group_max_session_timeout_ms: 30000
# Extra delay (in milliseconds) added to the rebalance phase to wait for new members.
# Default: 300ms
group_initial_rebalance_delay: 300
# Timeout (in milliseconds) for new member joins.
# Default: 30s
group_new_member_join_timeout: 30000
# Interaval for metadata dissemination batching.
# Default: 3s
metadata_dissemination_interval_ms: 3000
# Delete segments older than this.
# Default; 1 week
delete_retention_ms: 604800000
# How often do we trigger background compaction.
# Default: 5min
log_compaction_interval_ms: 300000
# Max bytes per partition on disk before triggering a compaction.
# Default: null
retention_bytes: 1024
# Number of partitions in the internal group membership topic.
# Default: 1
group_topic_partitions: 1
# Default replication factor for new topics.
# Default: 1
default_topic_replication: 1
# Timeout (in milliseconds) to wait when creating a new topic.
# Default: 2s
create_topic_timeout_ms: 2000
# Timeout (in milliseconds) to wait for leadership in metadata cache.
# Default: 5s
wait_for_leader_timeout_ms: 5000
# Default number of partitions per topic.
# Default: 1
default_topic_partitions: 1
# Disable batch cache in log manager.
# Default: false
disable_batch_cache: false
# Election timeout expressed in milliseconds.
# Default: 1.5s
raft_election_timeout_ms: 1500
# Kafka group recovery timeout expressed in milliseconds.
# Default: 30s
kafka_group_recovery_timeout_ms: 30000
# Timeout for append entries requests issued while replicating entries.
# Default: 3s
replicate_append_timeout_ms: 3000
# Timeout for append entries requests issued while updating a stale follower.
# Default: 5s
recovery_append_timeout_ms:
# Minimum batch cache reclaim size.
# Default: 128 KiB
reclaim_min_size: 131072
# Maximum batch cache reclaim size.
# Default: 4MiB
reclaim_max_size: 4194304
# Length of time (in milliseconds) in which reclaim sizes grow.
# Default: 3s
reclaim_growth_window: 3000
# Length of time (in milliseconds) above which growth is reset.
# 10s
reclaim_stable_window: 10000
# Allow topic auto creation.
# Default: false
auto_create_topics_enabled: false
# Enable pid file. You probably don't want to change this.
# Default: true
enable_pid_file: true
# Key-value store flush interval (in milliseconds).
# Default: 10ms
kvstore_flush_interval: 10
# Key-value maximum segment size (bytes).
kvstore_max_segment_size: 16777220
# Fail-safe maximum throttle delay on kafka requests.
# Default: 60s
max_kafka_throttle_delay_ms: 60000
# Raft I/O timeout.
# Default: 10s
raft_io_timeout_ms: 10000