Struct Config 

pub struct Config {
    pub port: u16,
    pub max_memory_bytes: u64,
    pub max_stream_bytes: u64,
    pub cors_origins: String,
    pub long_poll_timeout: Duration,
    pub sse_reconnect_interval_secs: u64,
    pub storage_mode: StorageMode,
    pub data_dir: String,
    pub acid_shard_count: usize,
    pub tls_cert_path: Option<String>,
    pub tls_key_path: Option<String>,
    pub rust_log: String,
}

Server configuration

Fields

port: u16

Port to bind the server to

max_memory_bytes: u64

Maximum total memory usage in bytes

max_stream_bytes: u64

Maximum bytes per stream

cors_origins: String

CORS allowed origins (comma-separated, “*” for all)

long_poll_timeout: Duration

Long-poll timeout duration

sse_reconnect_interval_secs: u64

SSE reconnect interval in seconds (0 disables).

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

storage_mode: StorageMode

Selected storage mode

data_dir: String

Root directory for file/acid-backed storage.

Matches Caddy’s data_dir.

acid_shard_count: usize

Number of shards for acid/redb storage mode.

tls_cert_path: Option<String>

Optional TLS certificate path (PEM). Requires tls_key_path.

tls_key_path: Option<String>

Optional TLS private key path (PEM or PKCS#8). Requires tls_cert_path.

rust_log: String

Default log filter 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.