Struct ServerConfig 

pub struct ServerConfig {
    pub serve: Option<ServeConfig>,
    pub handlers: Option<HandlersConfig>,
    pub cluster: Option<ClusterConfig>,
    pub compute: Option<ComputeConfig>,
    pub security: Option<SecurityConfig>,
    pub secrets: Option<SecretsConfig>,
}

Server daemon configuration, loaded from boatramp.cfg (RON). Read by boatramp serve; flags/env override the serve values.

Fields

serve: Option<ServeConfig>

Server defaults for serve (flag/env override these).

handlers: Option<HandlersConfig>

Server-side handler runtime config (which backend serves each binding), consumed only with the handlers feature.

cluster: Option<ClusterConfig>

Self-hosted cluster mode (consumed only with the cluster feature).

compute: Option<ComputeConfig>

Opt-in compute backends. Present ⇒ this node runs compute workloads via the backends it can offer; absent ⇒ no compute (the reconcile loop stays a no-op).

security: Option<SecurityConfig>

Operator security posture (the hardening knobs): a profile preset + overrides, resolved at startup. Absent ⇒ the strict multi-tenant default. Operator-only — never part of site config.

secrets: Option<SecretsConfig>

Secrets-at-rest envelope. Absent ⇒ private keys stored cleartext in the (replicated) control plane.

Implementations

impl ServerConfig

pub fn parse(text: &str) -> Result<Self, ConfigError>

Parse a boatramp.cfg document as RON (the default). Kept for the existing callers/tests; Self::parse_with_format is the format-aware entry point.

pub fn parse_with_format( text: &str, fmt: ConfigFormat, ) -> Result<Self, ConfigError>

Parse a boatramp.cfg document in fmt (RON or JSON). The deserializer is selected by format (RON ⇒ ron_options, JSON ⇒ serde_json) into the SAME typed struct. Db-binding names declared in the file are validated here (the same fail-closed check load re-runs after the env merge) regardless of format, so a file-only config path — e.g. boatramp cloudflare rendering, or the operator-resources loader — is guarded even without going through load.

pub fn load( path: &Path, override_: Option<ConfigFormat>, ) -> Result<Self, ConfigError>

Load from path, decoding as RON or JSON per resolve_format (override_ wins; else .json ⇒ JSON, everything else ⇒ RON), then layer BOATRAMP_* environment overrides on top. A missing file yields the default config, so serve can be configured entirely from the environment (12-factor deployments where dropping a boatramp.cfg is awkward — fly.io / Cloudflare / containers).

The env-override merge runs AFTER the parse for either format — JSON is only an alternative decoder into the same typed struct; it does not change the file < env precedence.

Trait Implementations

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

where ServerConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.