config.yaml.example

# Distributed Message Broker configuration.
# Copy to config.yaml (or pass -config <path>). Precedence:
# defaults < this file < BROKER_* environment variables < CLI flags.

# Node Configuration
node:
  id: "broker-1"                # Unique node identifier (required)
  data_dir: "./data"            # Data storage directory (default: ./data/<node-id>)

# Network Configuration
network:
  grpc_port: 8080               # Client API port
  raft_port: 9080               # Raft consensus port
  data_port: 9180               # Inter-broker replication port
  metrics_port: 9090            # Prometheus metrics port
  bind_addr: "0.0.0.0"          # Bind address (0.0.0.0 = all interfaces)
  advertise_addr: ""            # Address peers dial (empty = localhost)

# Cluster Configuration
cluster:
  join_addr: ""                 # Join existing cluster (e.g., "broker-1:8080");
                                # empty = bootstrap a new cluster
  controller: true              # Run as controller node

# Storage Configuration
storage:
  max_segment_bytes: 16777216   # 16 MB per segment (max 4 GiB)
  sync_writes: true             # Fsync after writes (false = faster, less durable)

# Retention Configuration (applies to all topics by default)
retention:
  default_max_age: "168h"       # 7 days
  default_max_bytes: 1073741824 # 1 GB
  cleanup_interval: "10m"

# Logging Configuration
logging:
  level: "info"                 # debug, info, warn, error
  format: "json"                # json, text