Skip to main content

Module config

Module config 

Source
Expand description

Configuration parsing for container storage.

This module provides structures for parsing storage.conf files used by containers-storage. Configuration files define storage locations, drivers, and additional read-only image stores.

§Overview

Container storage configuration is typically found in:

  • System-wide: /etc/containers/storage.conf
  • User-specific: ~/.config/containers/storage.conf

The configuration uses TOML format and specifies the storage driver (overlay, btrfs, etc.), root paths, and additional layer/image stores.

§Configuration Structure

A typical storage.conf file looks like:

[storage]
driver = "overlay"
root = "/var/lib/containers/storage"
run_root = "/run/containers/storage"

# Additional read-only image stores
image_stores = [
    "/usr/share/containers/storage"
]

# Additional layer stores configuration
[[storage.layer_stores]]
path = "/mnt/layers"
with_reference = true

Structs§

AdditionalLayerStore
Configuration for an additional layer store.
StorageConfig
Storage configuration, typically parsed from storage.conf files.