Struct Config 

pub struct Config {

    pub port: u16,
    pub max_memory_bytes: u64,
    pub max_stream_bytes: u64,
    pub max_stream_name_bytes: usize,
    pub max_stream_name_segments: usize,
    pub cors_origins: String,
    pub long_poll_timeout: Duration,
    pub sse_reconnect_interval_secs: u64,
    pub stream_base_path: String,
    pub storage_mode: StorageMode,
    pub data_dir: String,
    pub acid_shard_count: usize,
    pub acid_backend: AcidBackend,
    pub tls_cert_path: Option<String>,
    pub tls_key_path: Option<String>,
    pub rust_log: String,
}

Server configuration

Fields

port: u16

TCP port to bind the server to.

max_memory_bytes: u64

Maximum total in-process payload bytes across all streams.

max_stream_bytes: u64

Maximum payload bytes retained for any single stream.

max_stream_name_bytes: usize

Maximum byte length of a stream name.

max_stream_name_segments: usize

Maximum number of /-separated segments in a stream name.

cors_origins: String

CORS allowlist as "*" or a comma-separated origin list.

long_poll_timeout: Duration

Long-poll timeout used by GET ?live=long-poll.

sse_reconnect_interval_secs: u64

SSE reconnect interval in seconds (0 disables forced reconnects).

Matches Caddy’s sse_reconnect_interval. Connections are closed after this many idle seconds to enable CDN request collapsing.

stream_base_path: String

Mount path for the protocol HTTP surface.

storage_mode: StorageMode

Selected persistence backend.

data_dir: String

Root directory for file-backed and acid-backed storage.

Matches Caddy’s data_dir.

acid_shard_count: usize

Number of shards used by the acid/redb backend.

acid_backend: AcidBackend

Redb backend selection for the acid storage mode.

tls_cert_path: Option<String>

Optional TLS certificate path in PEM format. Requires tls_key_path.

tls_key_path: Option<String>

Optional TLS private key path in PEM or PKCS#8 format. Requires tls_cert_path.

rust_log: String

Default tracing filter used when RUST_LOG is not explicitly set.

Implementations

impl Config

pub fn from_env() -> Result<Self, String>

Load configuration from DS_* environment variables with sensible defaults.

Used by tests and as a simple entry point when TOML layering is not needed.

Errors

Returns an error when any DS_* environment variable is present but invalid.

pub fn from_sources(options: &ConfigLoadOptions) -> Result<Self, String>

Load configuration from layered TOML files plus environment overrides.

Order (later wins):

1. built-in defaults
2. config/default.toml (if present)
3. config/<profile>.toml (if present)
4. config/local.toml (if present)
5. --config <path> override file (if provided)
6. DS_* env vars

Errors

Returns an error when config files cannot be parsed or an explicit override file path does not exist/read.

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

Validate configuration invariants before server startup.

Errors

Returns an error string when config is internally inconsistent.

pub fn tls_enabled(&self) -> bool

True when direct TLS termination is enabled on this server.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.