unraidctl v1.5.1

Changelog

unraidctl v1.5.0

Changelog

• 85039c7 feat: cover Unraid API 4.37.5 mutations and subscriptions

unraidctl v1.4.0

Changelog

• 18b08ea feat: align CLI safety and live validation with template

unraidctl v1.3.1

Changelog

• 8198fa1 deps: bump github.com/vektah/gqlparser/v2 (#26)
• dd873b8 fix: protect API credentials and validate CLI writes
• 8ce6aad fix: secure config storage and release checks (#27)

unraidctl v1.3.0

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

unraidctl v1.2.0

Changelog

• a0ebce1 ci: bump actions/checkout from 4.2.2 to 7.0.1 (#18)
• 2c3e7da ci: bump actions/setup-go from 6.4.0 to 7.0.0 (#17)
• bf2e296 ci: bump golangci/golangci-lint-action from 9.2.1 to 9.3.0 (#15)
• 216bdd0 ci: bump goreleaser/goreleaser-action from 7.2.2 to 7.2.3 (#16)
• e8981f8 feat: add latest Unraid API features

unraidctl v1.1.0

Changelog

• 7cbbfc3 Add GitHub Actions CI/CD workflows
• 59218dc Add integration tests and update GitHub Actions to latest versions
• 4f6f651 Add repo metadata, Dependabot, and pin Actions to SHAs
• 9430c42 Fix Go version and add comprehensive tests
• 860a844 Fix lint issues: remove unused functions, check error returns
• 840e64e Fix remaining lint error in mock server test
• f91bc12 Merge remote-tracking branch 'origin/pr/10'
• 7822914 Merge remote-tracking branch 'origin/pr/11'
• 6f1d13b ci: bump actions/setup-go from 5.5.0 to 6.3.0 (#6)
• fc14fb0 ci: bump actions/setup-go from 6.3.0 to 6.4.0
• 7f4a820 ci: bump golangci/golangci-lint-action from 8.0.0 to 9.2.1
• 5240fb8 ci: bump goreleaser/goreleaser-action from 5.1.0 to 6.4.0 (#1)
• 1d26c0c ci: bump goreleaser/goreleaser-action from 6.4.0 to 7.2.2
• af0a7ee ci: drop unsupported go 1.21 job
• 12354dc feat: expand Unraid API command coverage
• e640032 fix: resolve errcheck lint violations for golangci-lint v2

v1.0.0

unraidctl v1.0.0

Initial release of unraidctl - a CLI tool to interact with the Unraid API.

Features

• System Information - View hostname, OS, CPU, and uptime
• Array Management - Check array status, capacity, and disk health
• Docker Containers - List containers with state and status
• Shares - List user shares with usage statistics
• Notifications - View unread and all notifications
• Virtual Machines - List VMs (when enabled)

Configuration

# Interactive setup
unraidctl configure

# Or use environment variables
export UNRAID_SERVER="http://192.168.1.100"
export UNRAID_API_KEY="your-api-key"

Installation

go install github.com/jwmoss/unraidctl@v1.0.0

Example Usage

unraidctl info
unraidctl array status
unraidctl docker list
unraidctl share list
unraidctl notification list

See CHANGELOG.md for full details.