Skip to content

unraidctl v1.3.0

Choose a tag to compare

@github-actions github-actions released this 20 Sep 19:35
18bf06a

This release adds health reports and supports Unraid API 4.37.4. The official Unraid API uses GraphQL.

New commands

  • health: array devices, raw UPS alarms, parity history, containers, sensors, and unread alert counts.
  • ups status and disk list: UPS measurements and physical disk inventory.
  • parity status and parity history: current and completed parity checks.
  • metrics cpu, metrics memory, and metrics temperature.
  • notification alerts: deduplicated unread warnings and alerts.

Fixes

  • notification list --all uses valid unread/archive filters and fetches every page.
  • Array status includes parity, cache, and boot devices.
  • Capacity uses correct decimal conversion and explicit binary unit labels.
  • Share output identifies shared storage capacity rather than folder size.
  • System info shows exact Unraid, API, and kernel versions.
  • VM listing explains when VM Manager is unavailable.

Upgrade notes

array remove-disk is retired because API 4.37.4 removes that operation. The command directs users to the Unraid WebGUI and sends no API request.

health exits 1 when alarms, warnings, or unavailable data need attention. JSON output retains available results. UPS checks use raw status because upstream battery health can be a fixed value. API checks do not include detailed SMART attributes, Btrfs counters, scrub results, or kernel I/O errors.

All 47 GraphQL operations pass schema validation against API 4.37.3 and 4.37.4. Build, unit tests, race tests, lint, and live read-only checks pass.

Download the archive for your platform and verify it with checksums.txt, or install with:

go install github.com/jwmoss/unraidctl/cmd/unraidctl@v1.3.0

Full changelog · Changes