Configuration

Reference for the configuration types in the OCM configuration file (.ocmconfig): credentials, resolvers, transfer, HTTP, caching, and versioning.

OCM reads its settings from a single configuration file, by default $HOME/.ocmconfig. The file carries a central generic.config.ocm.software/v1 document whose configurations: list holds one or more typed configuration entries. Each page in this section is the technical reference for one of those configuration types: its schema, fields, defaults, and precedence rules.

type: generic.config.ocm.software/v1
configurations:
  - type: credentials.config.ocm.software/v1
    # ...
  - type: ocm.config.ocm.software/v1
    # ...
  - type: transfer.config.ocm.software/v1alpha1
    # ...

Configuration references

Reference	Covers
Caching Configuration	OCI caches, cache location, limits, admission rules, and remote policy.
Credential Consumer Identities	Identity types and attributes OCM matches credentials against.
Credential Types	Built-in typed credential types and their fields.
HTTP Checksum Configuration	Schema, checksum modes, precedence, and the access-side fast path.
HTTP Client Configuration	Timeouts, retries, TLS trust, and per-host merge semantics.
Resolver Configuration	Repository resolution, component name patterns, and version constraints.
Transfer Configuration	Transfer settings, uploader configurations, resource matching, and CEL expressions.
Versioning Configuration	Scheme catalog, custom schemes, and OCI tag constraints.

Caching

Reference for the OCI caches used by the OCM CLI and controller: cache location, temporary folder, limits, admission rules, and remote policy.

Credential Consumer Identities

Complete reference for OCM credential consumer identity types, their attributes, and credential properties.

Credential Types

Reference for all built-in OCM credential types and their configuration fields.

HTTP Checksum

Complete reference for OCM HTTP checksum verification: schema, checksum modes, precedence rules, and the access-side fast path.

HTTP Client

Complete reference for OCM HTTP client configuration: schema, field descriptions, defaults, and per-host merge semantics.

Resolver

Complete reference for OCM resolver configuration: schema, repository types, and component name patterns.

Transfer Configuration

Reference for OCM transfer configuration: transfer settings, uploader configurations, resource matching, CEL expressions, and selection semantics.

Versioning

Reference for OCM versioning configuration: schema, built-in scheme catalog, custom schemes, and OCI tag constraints.