Struct ServerConfig 

pub struct ServerConfig {
    pub listen_addr: String,
    pub listen_port: Option<u16>,
    pub unix_socket: Option<String>,
    pub max_body_size: usize,
    pub worker_threads: usize,
    pub shutdown_timeout_secs: u64,
}

[server] section — network listener and general server tuning.

Fields

listen_addr: String

Listen address.

• "0.0.0.0:8443" or "[::]:8443" for TCP.
• "unix:/run/kipuka/kipuka.sock" or "/run/kipuka/kipuka.sock" for Unix.
• "fd:3" for systemd socket activation (LISTEN_FDS).

The KIPUKA_LISTEN environment variable overrides this field.

listen_port: Option<u16>

TCP listen port (ignored when listen_addr is a Unix socket or fd).

When set, overrides the port portion of listen_addr. Useful for separating the bind address from the port in deployment configs.

unix_socket: Option<String>

Unix socket path (alternative to embedding it in listen_addr).

When set, the server listens on this Unix domain socket instead of TCP. Mutually exclusive with listen_port.

max_body_size: usize

Maximum HTTP request body size in bytes.

EST CSR payloads (PKCS#10) are typically 1–4 KB; Full CMC requests can be larger. Default: 65536 (64 KiB).

worker_threads: usize

Number of tokio worker threads.

0 (the default) uses num_cpus threads.

shutdown_timeout_secs: u64

Graceful shutdown timeout in seconds.

After receiving SIGTERM/SIGINT, the server waits this long for in-flight requests to complete before forcing shutdown. Default: 30 seconds.

Implementations

impl ServerConfig

pub fn effective_listen_addr(&self) -> String

Resolve the effective listen target, accounting for overrides.

Priority: unix_socket > env KIPUKA_LISTEN > listen_addr.

pub fn is_unix_socket(&self) -> bool

Returns true when the effective listen target is a Unix domain socket.

pub fn is_systemd_fd(&self) -> bool

Returns true when the effective listen target uses systemd fd passing.

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.