Skip to content

Barn 0.3.0: explicit catalogs and actionable readiness

In Releases 310 words 2 min
Explicit image-catalog updates, per-node bootstrap diagnostics, native guest interface names, and a smaller CLI.
Note

Historical release record (0.3.0). Old release downloads are retired; use the installation guide for the current release.

Barn 0.3.0 replaces implicit catalog refreshes with explicit update commands, reports guest bootstrap failures per node, and streamlines the CLI surface while keeping the Pigsty inventory and fixed-IP deployment model.

What changed

  • Explicit catalog updates. up, plan, and standard image commands read the active local catalog snapshot without fetching remote metadata behind the scenes. Run barn update to fetch the latest signed catalog from the configured repository, or barn image sync to activate a specific URL or local file.
  • Per-node bootstrap diagnostics. Guest initialization records the active bootstrap stage atomically. Partial failures list each failed node, stage, and error message, and readiness timeouts point directly to barn logs <node>.
  • In-place readiness rechecks. Running guests can re-run readiness verification without restarting QEMU, and partial lifecycle runs still regenerate the host SSH client config for all committed nodes.
  • Native guest interface names. Netplan matches NICs by deterministic MAC address without renaming guest network interfaces, and vm_disks[].fs: auto prefers XFS with automatic fallback to ext4.
  • Streamlined CLI. The redundant ss command and ambiguous root/flag shorthands are removed, and barn image reset replaces reset-manifest (kept as an alias).

Validation

Source commit da6d02426da93c677c94c67fec4eb4fcecf4766a passed the full local source gate and a complete GoReleaser snapshot—covering unit and race tests, go vet, Staticcheck, govulncheck, four-target cross-builds, image-pipeline and installer checks, archive/package parity, dependency licenses, SBOMs, and Linux package verification—and the tag workflow repeated these gates before publication. Dated macOS arm64/HVF and Ubuntu amd64/KVM acceptance records are listed in the validation history.

Install or upgrade

Download the installer and assets from the Barn 0.3.0 GitHub Release:

curl -fLO https://github.com/pgsty/barn/releases/download/v0.3.0/install.sh
chmod +x install.sh
BARN_VERSION=0.3.0 ./install.sh
barn version
barn doctor

The release includes the Homebrew formula and amd64/arm64 DEB and RPM packages. Existing 0.1.0 and 0.2.0 deployment and catalog state remains compatible.

Last modified 2026-09-02