Struct Config 

pub struct Config {
    pub http_addr: SocketAddr,
    pub high_volume_storage: Storage,
    pub long_term_storage: Storage,
    pub runtime: Runtime,
    pub logging: Logging,
    pub sentry: Sentry,
    pub metrics: Metrics,
}

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

high_volume_storage: Storage

Storage backend for high-volume, small objects.

This backend is used for smaller objects in scenarios where high-throughput, low-latency access with many small objects is desired. Good candidates include Bigtable, local filesystem (for development), or fast SSDs. Can be set to the same backend as long_term_storage for simplicity.

Note: Currently, objects up to 1 MiB are stored in this backend, while larger objects are stored in the long_term_storage. This is subject to change in the future and more configuration options will be added to influence this decision.

Default

Filesystem storage in ./data/high-volume directory

Environment Variables

• OS__HIGH_VOLUME_STORAGE__TYPE for the backend type. See Storage for available options.

Example

high_volume_storage:
  type: bigtable
  project_id: my-project
  instance_name: objectstore
  table_name: objectstore

long_term_storage: Storage

Storage backend for large objects with long-term retention.

This backend is used for larger objects in scenarios with lower throughput and higher latency requirements. Good candidates include S3, Google Cloud Storage, or other object storage systems. Can be set to the same backend as high_volume_storage for simplicity.

Note: Currently, objects over 1 MiB are stored in this backend, while smaller objects are stored in the high_volume_storage. This is subject to change in the future and more configuration options will be added to influence this decision.

Default

Filesystem storage in ./data/long-term directory

Environment Variables

• OS__LONG_TERM_STORAGE__TYPE - Backend type (filesystem, s3compatible, gcs, bigtable)
• Additional fields depending on the type (see Storage)

Example

long_term_storage:
  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: Logging

Logging configuration.

Controls log verbosity and output format. See Logging 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: Metrics

Internal metrics configuration.

Optional configuration for submitting internal metrics to Datadog. See Metrics 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 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() -> 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.