Struct ServerConfig 

pub struct ServerConfig {

    pub listen: SocketAddr,
    pub pg_listen: SocketAddr,
    pub http_listen: SocketAddr,
    pub data_dir: PathBuf,
    pub data_plane_cores: usize,
    pub memory_limit: usize,
    pub max_connections: usize,
    pub engines: EngineConfig,
    pub auth: AuthConfig,
    pub tls: Option<TlsSettings>,
    pub encryption: Option<EncryptionSettings>,
    pub log_format: String,
    pub checkpoint: CheckpointSettings,
    pub resp_listen: Option<SocketAddr>,
    pub ilp_listen: Option<SocketAddr>,
    pub cluster: Option<ClusterSettings>,
    pub cold_storage: Option<ColdStorageSettings>,
    pub tuning: TuningConfig,
    pub observability: ObservabilityConfig,
}

Top-level server configuration.

Fields

listen: SocketAddr

Address to bind the native wire protocol listener.

pg_listen: SocketAddr

Address to bind the PostgreSQL wire protocol listener. Defaults to 127.0.0.1:5432.

http_listen: SocketAddr

Address to bind the HTTP API (health, metrics, REST). Defaults to 127.0.0.1:8080.

data_dir: PathBuf

Data directory for WAL, segments, and indexes.

data_plane_cores: usize

Number of Data Plane cores. Defaults to available CPUs minus one (reserving one core for the Control Plane).

memory_limit: usize

Global memory ceiling in bytes. The memory governor enforces this.

max_connections: usize

Maximum concurrent client connections across all listeners. Enforced at accept time via a shared semaphore — no permit means immediate TCP RST. Prevents connection floods from exhausting memory before per-tenant quotas kick in (those are checked post-authentication). 0 = unlimited (not recommended for production).

engines: EngineConfig

Per-engine budget configuration.

auth: AuthConfig

Authentication and authorization configuration.

tls: Option<TlsSettings>

Client TLS configuration. If present, pgwire connections support SSL.

encryption: Option<EncryptionSettings>

Encryption at rest configuration. If present, WAL payloads are encrypted.

log_format: String

Log output format: “text” (default, human-readable) or “json” (structured).

checkpoint: CheckpointSettings

Checkpoint and WAL management settings.

resp_listen: Option<SocketAddr>

Address to bind the RESP (Redis-compatible) KV protocol listener. Disabled by default (None). Enable for Redis-compatible key-value access. Default port: 6381 (distinct from Redis’s 6379).

ilp_listen: Option<SocketAddr>

Address to bind the ILP (InfluxDB Line Protocol) TCP listener. Disabled by default (None). Enable for timeseries ingest. Standard InfluxDB port: 8086.

cluster: Option<ClusterSettings>

Cluster mode settings. When present, the node participates in a distributed cluster via Multi-Raft consensus over QUIC transport. When absent, runs in single-node mode (default).

cold_storage: Option<ColdStorageSettings>

Cold storage (L2 tiering) configuration. When present, old L1 segments are promoted to S3-compatible cold storage.

tuning: TuningConfig

Performance tuning knobs for engines, query execution, WAL, bridge, network, and cluster transport. All fields have sensible defaults; override selectively via the [tuning] TOML section.

observability: ObservabilityConfig

Observability integrations: PromQL, OTLP receiver/export. Requires corresponding cargo features (promql, otel) at compile time.

Implementations

impl ServerConfig

pub fn from_file(path: &Path) -> Result<Self>

Load configuration from a TOML file, falling back to defaults.

pub fn wal_dir(&self) -> PathBuf

WAL directory within the data directory.

pub fn segments_dir(&self) -> PathBuf

Segments directory within the data directory.

pub fn catalog_path(&self) -> PathBuf

System catalog (auth, roles, tenants) redb file.

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ServerConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServerConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ServerConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.