Struct BhtuneConfig 

pub struct BhtuneConfig {

    pub server_mode: Option<ServerMode>,
    pub demo: DemoPolicyConfig,
    pub db: Option<PathBuf>,
    pub bridge_host: Option<String>,
    pub server: Option<String>,
    pub templates: Option<PathBuf>,
    pub bind: Option<String>,
    pub origin: Option<String>,
    pub trusted_proxy: Option<String>,
    pub retention_days: Option<u32>,
    pub allow_uncertain_quality: bool,
    pub tuning: TuningConfig,
    pub log: LogConfig,
}

bhtune’s configuration, loaded from an optional TOML file. Every field is optional; a value missing from the file (or the file itself missing) falls back to the env var / CLI flag / built-in default resolution in the resolve_* functions below.

Fields

server_mode: Option<ServerMode>

Runtime server mode. The environment variable BHTUNE_SERVER_MODE overrides this.

demo: DemoPolicyConfig

Safety limits for the simulator-only public demo mode.

db: Option<PathBuf>

Overrides the default SQLite database path (see [default_db_path_from]).

bridge_host: Option<String>

Overrides DEFAULT_BRIDGE_HOST for every tune --driver opcda and opc subcommand invocation that doesn’t pass --bridge-host explicitly.

server: Option<String>

Default OPC DA server ProgID, used when --server is omitted. Unlike the other fields there is no built-in default – if this is unset and --server is omitted, the command errors (see [resolve_server]).

templates: Option<PathBuf>

Overrides the default user-supplied DCS/PLC template catalog path (see [templates_path_from]). A file here is loaded on every startup in addition to the embedded built-in catalog (see crate::db::open and [load_user_templates]), attributed TemplateOrigin::Catalog.

bind: Option<String>

Overrides DEFAULT_BIND_ADDR – the host:port bhtune-server listens on. Only meaningful to the server binary; see [resolve_bind_addr].

origin: Option<String>

Optional exact browser origin for state-changing HTTP requests. BHTUNE_ORIGIN overrides this value. Full mode automatically matches the browser origin to the request host when this is unset; set it for a reverse proxy that rewrites Host or to pin one public origin. Demo mode always requires an exact configured origin and requires HTTPS, except for explicit loopback HTTP origins used by local tests and development.

trusted_proxy: Option<String>

IP address or matching-family CIDR of a reverse proxy trusted to supply the single-address X-BHTune-Client-IP header for Demo quota accounting.

retention_days: Option<u32>

Age-based history retention (history-retention): tune runs with started_at older than this many days are deleted automatically on every startup (both binaries, via crate::db::open) and, for bhtune-server, again on a periodic timer while it keeps running – see crate::retention. A present value must be at least 1. None (the default) means retain forever: there is no built-in number of days, since at this project’s data volumes (see AGENTS.md’s History explorer notes) an unexpected auto-delete of someone’s baseline tune is a worse failure mode than an ever-growing database file. See [resolve_retention_days].

allow_uncertain_quality: bool

Default OPC sample-quality policy for the server config page: true accepts Uncertain quality, while false rejects it. A missing key is treated as true when the config file is parsed, matching the configuration-page default rather than bool’s ordinary false.

tuning: TuningConfig

Global tune timing defaults. Missing keys remain None and resolve through [resolve_tuning_config] only when a tune is prepared.

log: LogConfig

[log] sub-table: level/directory/format/rotation for crate::logging’s tracing setup, mirroring opcda-bridge-gateway’s own log.* config conventions.

Trait Implementations

impl Clone for BhtuneConfig

fn clone(&self) -> BhtuneConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BhtuneConfig

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

Formats the value using the given formatter.

impl Default for BhtuneConfig

fn default() -> BhtuneConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BhtuneConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<BhtuneConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BhtuneConfig

impl JsonSchema for BhtuneConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for BhtuneConfig

fn eq(&self, other: &BhtuneConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for BhtuneConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BhtuneConfig