raft / docs
Release notes

Raft 0.3.0

  • raft host add LOCATION --ssh TARGET onboards a host from the CLI. It checks the host read-only first and rejects unsupported targets such as macOS, shows the exact plan, and asks before changing anything (--dry-run previews, --yes skips the prompt). It provisions Incus, imports a checksum-verified release image (or --image-archive / --build), pins the fingerprint, and finishes with doctor and a disposable smoke test. A failed final check removes the new location again.
  • Boxes can use 8 GiB RAM: new, resume and fork accept --memory 8GiB, and raft limits reports recommendations for it. An 8 GiB box needs at least 10 GiB of usable host RAM before limits recommends running one.
  • Locations accept an optional note for operator guidance, such as which host is preferred or what a host should not run. raft note LOCATION TEXT sets it and raft note LOCATION --clear removes it.
  • raft locations lists configured locations as JSONL with their default status and note, without contacting hosts.
  • raft limits includes each location's note, and raft new prints the target location's note to stderr. Notes are advisory and never block allocation.

Install on Linux with Python 3.11.8+ using npm install -g @microck/raft@0.3.0, or install the attached Python wheel. Notes live in the controller configuration; host workers are unchanged and need no redeployment. Host onboarding needs the npm package or a source checkout because the Python wheel does not ship the deployment files.

ARM64 and AMD64 development images accompany this release. Verify SHA256SUMS before importing an image for your host architecture.

On this page