Skip to content

TrueNAS v2.1.0

Latest
Latest

Choose a tag to compare

View all tags
@kayl-codes kayl-codes released this 23 Jun 22:45
· 1 commit to master since this release
v2.1.0
e01c88d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Downloads for this release

⚠️ IMPORTANT — Home Assistant Domain Migration

This release requires a single manual action: Re-add the TrueNAS integration once (Settings → Devices & Services → Create Integration → TrueNAS CE).

Your data is safe:

  • ✅ All entities (sensors, binary sensors, switches) are migrated automatically
  • ✅ Entity history and long-term statistics are preserved
  • ✅ Automations, scripts, and dashboards continue to work
  • ✅ Migration takes less than 30 seconds — automatic with one-click config takeover

Full guide: docs/migration.md

✨ New Features

  • Monitor certificate expiry (#6) — Track TrueNAS certificate expiration with new sensors:

    • sensor.truenas_*_certificate_expiration_time — Timestamp when certificate expires
    • sensor.truenas_*_certificate_days_until_expiry — Days remaining (perfect for automation warnings)
    • binary_sensor.truenas_*_certificate_expired — Problem-class indicator when already expired

  • ZFS ARC hit ratio monitoring (#7) — Deep performance visibility into L2ARC cache efficiency:

    • sensor.truenas_*_arc_data_hit_ratio — Data cache hit percentage
    • sensor.truenas_*_arc_metadata_hit_ratio — Metadata cache hit percentage
    • sensor.truenas_*_arc_l2_hit_ratio — L2ARC secondary cache efficiency

  • System data refresh on demand (#10) — Force immediate coordinator update without waiting for the polling interval:

    • New system_refresh action targeting the system uptime sensor
    • Diagnostic "Refresh data" button on the TrueNAS device page
    • Useful after running manual actions (e.g., service restart, dataset lock/unlock) to capture state changes immediately in automations

🛠️ Core & Stability Improvements

  • Improved defensive error handling — ARC and certificate parsing now gracefully handle malformed or missing API responses (returns unknown instead of misleading 0% or false expirations)
  • Reduced code duplication — Consolidated netdata graph parsing into a shared helper (_netdata_mean_value) for ARC and UPS metrics
  • Cleaner type hints — Better alignment between parameter types and actual usage patterns

⚠️ Requirements & Notes

  • Home Assistant 2024.8.0+ required (unchanged)
  • TrueNAS 25.04+ required for new features (certificate.query, reporting.netdata_graph APIs)
  • Webhook/Polling unchanged — Still uses JSON-RPC WebSocket with 60-second poll interval
  • No new dependencies — websockets >= 15.0.1 (unchanged)

Generated with Claude Code

Assets 3
Loading