Struct Config 

pub struct Config {
    pub http_addr: SocketAddr,
    pub storage: StorageConfig,
    pub runtime: Runtime,
    pub logging: LoggingConfig,
    pub sentry: Sentry,
    pub metrics: MetricsConfig,
    pub auth: AuthZ,
    pub killswitches: Killswitches,
    pub rate_limits: RateLimits,
    pub service: Service,
    pub http: Http,
}

Main configuration struct for the objectstore server.

This is the top-level configuration that combines all server settings including networking, storage backends, runtime, and observability options.

Configuration is loaded with the following precedence (highest to lowest):

1. Environment variables (prefixed with OS__)
2. YAML configuration file (if provided via -c flag)
3. Default values

See individual field documentation for details on each configuration option, including defaults and environment variables.

Fields

http_addr: SocketAddr

HTTP server bind address.

The socket address (IP and port) where the HTTP server will listen for incoming connections. Supports both IPv4 and IPv6 addresses. Note that binding to 0.0.0.0 makes the server accessible from all network interfaces.

Default

0.0.0.0:8888 (listens on all network interfaces, port 8888)

Environment Variable

OS__HTTP_ADDR

storage: StorageConfig

Storage backend configuration.

Configures the storage backend used by the server. Use type: "filesystem" for development, type: "tiered" for production two-tier routing (small objects to a high-volume backend, large objects to a long-term backend), or any other single backend type for simple deployments.

Default

Filesystem storage in the ./data directory

Environment Variables

• OS__STORAGE__TYPE — backend type (filesystem, tiered, gcs, bigtable, s3compatible)
• Additional fields depending on the type (see StorageConfig)

For tiered storage, sub-backend fields are nested under high_volume and long_term:

• OS__STORAGE__TYPE=tiered
• OS__STORAGE__HIGH_VOLUME__TYPE=bigtable
• OS__STORAGE__LONG_TERM__TYPE=gcs

Example (tiered)

storage:
  type: tiered
  high_volume:
    type: bigtable
    project_id: my-project
    instance_name: objectstore
    table_name: objectstore
  long_term:
    type: gcs
    bucket: my-objectstore-bucket

runtime: Runtime

Configuration of the internal task runtime.

Controls the thread pool size and behavior of the async runtime powering the server. See Runtime for configuration options.

logging: LoggingConfig

Logging configuration.

Controls log verbosity and output format. See LoggingConfig for configuration options.

sentry: Sentry

Sentry error tracking configuration.

Optional integration with Sentry for error tracking and performance monitoring. See Sentry for configuration options.

metrics: MetricsConfig

Internal metrics configuration.

Configures submission of internal metrics to a DogStatsD-compatible endpoint. See objectstore_metrics::MetricsConfig for configuration options.

auth: AuthZ

Content-based authorization configuration.

Controls the verification and enforcement of content-based access control based on the JWT in a request’s Authorization header.

killswitches: Killswitches

A list of matchers for requests to discard without processing.

rate_limits: RateLimits

Definitions for rate limits to enforce on incoming requests.

service: Service

Configuration for the StorageService.

http: Http

Configuration for the HTTP layer.

Controls HTTP-level settings that operate before requests reach the storage service. See Http for configuration options.

Implementations

impl Config

pub fn load(path: Option<&Path>) -> Result<Self>

Loads configuration from the provided arguments.

Configuration is merged in the following order (later sources override earlier ones):

1. Default values
2. YAML configuration file (if provided in args)
3. Environment variables (prefixed with OS__)

Errors

Returns an error if:

• The YAML configuration file cannot be read or parsed
• Environment variables contain invalid values
• Required fields are missing or invalid

Trait Implementations

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

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.