Struct ServerConfig 

pub struct ServerConfig {

    pub server: ServerSection,
    pub engines: EngineConfig,
    pub auth: AuthConfig,
    pub encryption: Option<EncryptionSettings>,
    pub backup_encryption: Option<BackupEncryptionSettings>,
    pub checkpoint: CheckpointSettings,
    pub retention: RetentionSettings,
    pub cluster: Option<ClusterSettings>,
    pub cold_storage: Option<ColdStorageSettings>,
    pub snapshot_storage: Option<SnapshotStorageSettings>,
    pub quarantine_storage: Option<QuarantineStorageSettings>,
    pub tuning: TuningConfig,
    pub observability: ObservabilityConfig,
    pub scheduler: SchedulerConfig,
}

Root configuration for the NodeDB server.

On disk this is a TOML document with [server] for runtime fields and independent subsystem tables ([auth], [tls], [cluster], [engines], …) as siblings at the root. deny_unknown_fields rejects typos and stray tables so misconfiguration surfaces at startup instead of being silently ignored.

Example:

[server]
host         = "0.0.0.0"
data_dir     = "/var/lib/nodedb"
memory_limit = "4GiB"

[server.ports]
pgwire = 6432
native = 6433
http   = 6480

[auth]
# ...

Fields

server: ServerSection

Server-level runtime fields (bind address, ports, resource budgets, on-disk location, log format).

engines: EngineConfig

Per-engine budget configuration. Lives under [engines].

auth: AuthConfig

Authentication and authorization configuration.

encryption: Option<EncryptionSettings>

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

backup_encryption: Option<BackupEncryptionSettings>

Per-backup encryption configuration. If present, every backup envelope is encrypted with a per-backup DEK wrapped by this KEK. If absent, a warning is emitted once per process at the first backup operation. The key MUST differ from the WAL key; a matching path triggers a warning.

checkpoint: CheckpointSettings

Checkpoint and WAL management settings.

retention: RetentionSettings

Collection-lifecycle retention settings. Drives when the Event-Plane collection-GC sweeper hard-deletes a soft-deleted collection, and how often it evaluates candidates.

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.

snapshot_storage: Option<SnapshotStorageSettings>

Snapshot storage configuration. Controls where warm-tier snapshots are persisted. When absent, defaults to local filesystem at {data_dir}/snapshots.

quarantine_storage: Option<QuarantineStorageSettings>

Quarantine storage configuration. Controls where corrupt-segment archives are stored. When absent, defaults to local filesystem at {data_dir}/quarantine.

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. All capabilities are always compiled in; toggled at runtime via this config.

scheduler: SchedulerConfig

Cron scheduler settings (timezone offset, future tuning knobs).

Implementations

impl ServerConfig

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

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

pub fn validate(&self) -> Result<()>

Validate cross-field invariants that serde cannot express. Called from Self::from_file so misconfiguration fails startup.

pub fn addr(&self, port: u16) -> SocketAddr

Build a SocketAddr from the shared host and a port.

pub fn native_addr(&self) -> SocketAddr

Native protocol listen address.

pub fn pgwire_addr(&self) -> SocketAddr

pgwire listen address.

pub fn http_addr(&self) -> SocketAddr

HTTP API listen address.

pub fn resp_addr(&self) -> Option<SocketAddr>

RESP listen address (None if disabled).

pub fn ilp_addr(&self) -> Option<SocketAddr>

ILP listen address (None if disabled).

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() -> ServerConfig

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.