Struct Config 

pub struct Config {
    pub node: NodeConfig,
    pub tun: TunConfig,
    pub dns: DnsConfig,
    pub transports: TransportsConfig,
    pub peers: Vec<PeerConfig>,
    pub gateway: Option<GatewayConfig>,
}

Root configuration structure.

Fields

node: NodeConfig

Node configuration (node.*).

tun: TunConfig

TUN interface configuration (tun.*).

dns: DnsConfig

DNS responder configuration (dns.*).

transports: TransportsConfig

Transport instances (transports.*).

peers: Vec<PeerConfig>

Static peers to connect to (peers).

gateway: Option<GatewayConfig>

Gateway configuration (gateway).

Implementations

impl Config

pub fn new() -> Self

Create a new empty configuration.

pub fn load() -> Result<(Self, Vec<PathBuf>), ConfigError>

Load configuration from the standard search paths.

Files are loaded in reverse priority order and merged:

1. /etc/fips/fips.yaml (loaded first, lowest priority)
2. ~/.config/fips/fips.yaml (user config)
3. ./fips.yaml (loaded last, highest priority)

Returns a tuple of (config, paths_loaded) where paths_loaded contains the paths that were successfully loaded.

pub fn load_from_paths( paths: &[PathBuf], ) -> Result<(Self, Vec<PathBuf>), ConfigError>

Load configuration from specific paths.

Paths are processed in order, with later paths overriding earlier ones.

pub fn load_file(path: &Path) -> Result<Self, ConfigError>

Load configuration from a single file.

pub fn search_paths() -> Vec<PathBuf>

Get the standard search paths in priority order (lowest to highest).

pub fn merge(&mut self, other: Config)

Merge another configuration into this one.

Values from other override values in self when present.

pub fn create_identity(&self) -> Result<Identity, ConfigError>

Create an Identity from this configuration.

If an nsec is configured, uses that to create the identity. Otherwise, generates a new random identity.

pub fn has_identity(&self) -> bool

Check if an identity is configured (vs. will be generated).

pub fn is_leaf_only(&self) -> bool

Check if leaf-only mode is configured.

pub fn peers(&self) -> &[PeerConfig]

Get the configured peers.

pub fn auto_connect_peers(&self) -> impl Iterator<Item = &PeerConfig>

Get peers that should auto-connect on startup.

pub fn validate(&self) -> Result<(), ConfigError>

Validate cross-field configuration invariants.

pub fn to_yaml(&self) -> Result<String, Error>

Serialize this configuration to YAML.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.