Skip to main content
Version: v5.6.1

opschain settings

Included from Basic tier

Manages the stored settings documents on a server's nodes — the versioned documents that configure behaviour per project, environment or asset (e.g. the runner block that places a node's runs on the fleet — opschain docs fleet-queue), as opposed to properties, which carry the data actions consume. Server-only: pass --server <url> or select a context with opschain context use.

SubcommandDoesPage
showShow a node's stored settings document (or one version)opschain docs cli/settings-show
historyList a node's stored settings versions, newest firstopschain docs cli/settings-history
editReplace the document as a new version (compare-and-set)opschain docs cli/settings-edit

The verbs are the same machinery as the opschain properties server verbs — one document family, the same addressing (a positional node path resolved through the node's settings relationship), the same versioned compare-and-set writes.

See also​

  • opschain docs cli/properties — the sibling document family.
  • opschain learn 1.3 — properties and settings, guided.