Struct Config 

#[non_exhaustive]
pub struct Config {

    pub server: Config,
    pub database: Config,
    pub tracing: Config,
    pub cookie: Option<CookieConfig>,
    pub security_headers: SecurityHeadersConfig,
    pub cors: CorsConfig,
    pub csrf: CsrfConfig,
    pub rate_limit: RateLimitConfig,
    pub session: SessionConfig,
    pub job: JobConfig,
    pub trusted_proxies: Vec<String>,
    pub oauth: OAuthConfig,
    pub email: EmailConfig,
    pub template: TemplateConfig,
    pub geolocation: GeolocationConfig,
    pub storage: BucketConfig,
    pub dns: DnsConfig,
    pub apikey: ApiKeyConfig,
    pub jwt: JwtConfig,
}

Top-level framework configuration.

Deserializes from a YAML file loaded by crate::config::load. All fields use #[serde(default)], so any section omitted from the YAML file falls back to the type’s own Default implementation.

Applications that need extra config fields can embed Config with #[serde(flatten)] inside their own config struct.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

server: Config

HTTP server bind address and shutdown behaviour.

database: Config

libsql database settings.

tracing: Config

Log level, format, and optional Sentry integration.

cookie: Option<CookieConfig>

Signed cookie secret and attributes. When absent, signed/private cookies are disabled.

security_headers: SecurityHeadersConfig

HTTP security-header middleware settings.

cors: CorsConfig

CORS policy.

csrf: CsrfConfig

CSRF protection settings.

rate_limit: RateLimitConfig

Token-bucket rate-limiting settings.

session: SessionConfig

Session TTL, cookie name, fingerprint validation, touch interval, and per-user session limit.

job: JobConfig

Background job queue settings.

trusted_proxies: Vec<String>

CIDR ranges of trusted reverse proxies used by crate::ip::ClientIpLayer.

Accepts any string parseable as ipnet::IpNet, e.g. "10.0.0.0/8".

oauth: OAuthConfig

OAuth provider settings.

email: EmailConfig

SMTP / email delivery settings.

template: TemplateConfig

MiniJinja template engine settings.

geolocation: GeolocationConfig

MaxMind GeoIP database path and settings.

storage: BucketConfig

S3-compatible storage bucket settings.

dns: DnsConfig

DNS verification settings.

apikey: ApiKeyConfig

API key module settings.

jwt: JwtConfig

JWT signing and validation settings.

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

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

where Config: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.