Struct ServerConfig 

pub struct ServerConfig {

    pub bind_addr: SocketAddr,
    pub tls: Option<TlsConfig>,
    pub auth: Option<AuthConfig>,
    pub max_message_size: usize,
    pub max_upload_size: usize,
    pub enable_grpc_web: bool,
    pub enable_reflection: bool,
    pub blob_chunk_size: usize,
    pub stream_channel_capacity: usize,
    pub rate_limit: Option<RateLimitConfig>,
    pub audit: Option<AuditConfig>,
    pub shutdown: Option<ShutdownConfig>,
    pub metrics: Option<MetricsConfig>,
    pub max_concurrent_connections: Option<usize>,
    pub max_concurrent_streams_per_connection: Option<u32>,
    pub initial_window_size: Option<u32>,
    pub initial_connection_window_size: Option<u32>,
    pub request_timeout: Option<Duration>,
    pub memory_budget: Option<MemoryBudgetConfig>,
    pub rest_addr: Option<SocketAddr>,
    pub web_addr: Option<SocketAddr>,
    pub streaming: Option<StreamingConfig>,
    pub cluster: Option<ClusterConfig>,
    pub rest_config: RestConfig,
}

Server configuration.

Fields

bind_addr: SocketAddr

Address to bind the server to.

tls: Option<TlsConfig>

TLS configuration (optional).

auth: Option<AuthConfig>

Authentication configuration (optional).

max_message_size: usize

Maximum message size in bytes.

max_upload_size: usize

Maximum upload size for blob service in bytes.

enable_grpc_web: bool

Enable gRPC-web support for browser clients.

enable_reflection: bool

Enable reflection service for debugging.

blob_chunk_size: usize

Blob streaming chunk size.

stream_channel_capacity: usize

Channel capacity for streaming responses (backpressure control).

rate_limit: Option<RateLimitConfig>

Rate limiting configuration (optional).

audit: Option<AuditConfig>

Audit logging configuration (optional).

shutdown: Option<ShutdownConfig>

Graceful shutdown configuration (optional).

metrics: Option<MetricsConfig>

Metrics configuration (optional).

max_concurrent_connections: Option<usize>

Maximum concurrent connections (None = unlimited).

max_concurrent_streams_per_connection: Option<u32>

Maximum HTTP/2 streams per connection.

initial_window_size: Option<u32>

HTTP/2 initial window size.

initial_connection_window_size: Option<u32>

HTTP/2 connection window size.

request_timeout: Option<Duration>

Request timeout.

memory_budget: Option<MemoryBudgetConfig>

Memory budget configuration (optional).

rest_addr: Option<SocketAddr>

REST API bind address (optional, None disables REST API).

web_addr: Option<SocketAddr>

Web admin UI bind address (optional, None disables Web UI).

streaming: Option<StreamingConfig>

Enhanced streaming configuration (optional).

cluster: Option<ClusterConfig>

Cluster configuration for distributed mode (optional).

rest_config: RestConfig

REST API configuration (CORS, body limits, etc.).

Implementations

impl ServerConfig

pub fn new() -> Self

Create a new server configuration with default values.

pub fn from_env() -> Result<Self>

Load configuration from environment variables.

Unset variables use defaults. Invalid values return an error.

Supported Environment Variables

• NEUMANN_BIND_ADDR - Server bind address (e.g., “0.0.0.0:9200”)
• NEUMANN_MAX_MESSAGE_SIZE - Maximum message size in bytes
• NEUMANN_MAX_UPLOAD_SIZE - Maximum upload size in bytes
• NEUMANN_ENABLE_GRPC_WEB - Enable gRPC-Web (true/false)
• NEUMANN_ENABLE_REFLECTION - Enable reflection (true/false)
• NEUMANN_TLS_CERT_PATH - Path to TLS certificate
• NEUMANN_TLS_KEY_PATH - Path to TLS private key
• NEUMANN_TLS_CA_CERT_PATH - Path to CA certificate (optional)
• NEUMANN_RATE_LIMIT_MAX_REQUESTS - Max requests per window
• NEUMANN_RATE_LIMIT_MAX_QUERIES - Max queries per window
• NEUMANN_RATE_LIMIT_WINDOW_SECS - Rate limit window in seconds
• NEUMANN_SHUTDOWN_DRAIN_TIMEOUT_SECS - Shutdown drain timeout
• NEUMANN_SHUTDOWN_GRACE_PERIOD_SECS - Shutdown grace period
• NEUMANN_BLOB_CHUNK_SIZE - Blob streaming chunk size
• NEUMANN_STREAM_CHANNEL_CAPACITY - Stream channel capacity
• NEUMANN_MAX_CONCURRENT_CONNECTIONS - Max concurrent connections
• NEUMANN_MAX_CONCURRENT_STREAMS - Max HTTP/2 streams per connection
• NEUMANN_INITIAL_WINDOW_SIZE - HTTP/2 initial window size
• NEUMANN_INITIAL_CONNECTION_WINDOW_SIZE - HTTP/2 connection window
• NEUMANN_REQUEST_TIMEOUT_SECS - Request timeout in seconds
• NEUMANN_MEMORY_BUDGET_MAX_BYTES - Memory budget in bytes
• NEUMANN_MEMORY_BUDGET_LOAD_SHEDDING - Enable load shedding (true/false)

Errors

Returns ServerError::Config if any environment variable has an invalid value.

pub const fn with_bind_addr(self, addr: SocketAddr) -> Self

Set the bind address.

pub fn with_tls(self, tls: TlsConfig) -> Self

Set TLS configuration.

pub fn with_auth(self, auth: AuthConfig) -> Self

Set authentication configuration.

pub const fn with_max_message_size(self, size: usize) -> Self

Set maximum message size.

pub const fn with_grpc_web(self, enabled: bool) -> Self

Enable or disable gRPC-web support.

pub const fn with_reflection(self, enabled: bool) -> Self

Enable or disable reflection service.

pub const fn with_blob_chunk_size(self, size: usize) -> Self

Set blob streaming chunk size.

pub const fn with_max_upload_size(self, size: usize) -> Self

Set the maximum upload size for blob service.

pub const fn with_stream_channel_capacity(self, capacity: usize) -> Self

Set the channel capacity for streaming responses.

Lower values provide better backpressure at the cost of throughput. Higher values allow more buffering but may use more memory.

pub const fn with_rate_limit(self, config: RateLimitConfig) -> Self

Set rate limiting configuration.

pub const fn with_audit(self, config: AuditConfig) -> Self

Set audit logging configuration.

pub const fn with_shutdown(self, config: ShutdownConfig) -> Self

Set graceful shutdown configuration.

pub fn with_metrics(self, config: MetricsConfig) -> Self

Set metrics configuration.

pub const fn with_max_concurrent_connections(self, max: usize) -> Self

Set maximum concurrent connections.

pub const fn with_max_concurrent_streams_per_connection(self, max: u32) -> Self

Set maximum concurrent HTTP/2 streams per connection.

pub const fn with_initial_window_size(self, size: u32) -> Self

Set HTTP/2 initial window size.

pub const fn with_initial_connection_window_size(self, size: u32) -> Self

Set HTTP/2 connection window size.

pub const fn with_request_timeout(self, timeout: Duration) -> Self

Set request timeout.

pub const fn with_memory_budget(self, config: MemoryBudgetConfig) -> Self

Set memory budget configuration.

pub const fn with_rest_addr(self, addr: SocketAddr) -> Self

Set REST API bind address.

pub const fn with_web_addr(self, addr: SocketAddr) -> Self

Set Web admin UI bind address.

pub const fn with_streaming(self, config: StreamingConfig) -> Self

Set streaming configuration.

pub fn with_rest_config(self, config: RestConfig) -> Self

Set REST API configuration (CORS, body limits, etc.).

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

Validate the configuration.

Errors

Returns ServerError::Config if any configuration value is invalid.

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.