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>

Exact browser origin allowed for state-changing HTTP requests. BHTUNE_ORIGIN overrides this value. Demo mode 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

Formats the value using the given formatter.

impl Default for BhtuneConfig

fn default() -> Self

Returns the “default value” for a type.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for BhtuneConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BhtuneConfig