Reference
Exact contracts for the Pigsty-compatible Inventory and Barn command line.
This reference describes the Barn 0.9.0 release candidate. Check
barn version before scripting against these contracts. See the release status.
- Configuration — discovery, accepted variables, defaults, disks, shares, naming, and drift.
- CLI — commands, important flags, output modes, and exit codes.
- Mac Commands — the unreleased
barn mac: commands, JSON results, and failure reasons. - Images — signed catalogs, aliases, cache layout, pulls, imports, and pruning.
- Image Pipeline — candidate validation and offline normalization.
Barn exposes no supported Go library API. Packages under internal/ are
implementation details.
The Pigsty-compatible Inventory fields Barn reads, their defaults, and node-level drift behavior.
Barn commands, important flags, structured output, and exit codes.
barn mac commands and flags, machine rules, JSON results, failure reasons, networks, and files.
Signed catalogs, built-in aliases, repository selection, local cache verification, imports, and pruning.
Validate or offline-normalize an explicit qcow2 candidate without downloading, uploading, or signing it.