TrueNAS v2.1.0

⚠️ 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

TrueNAS 2.0.0

🚀 v2.0.0 — TrueNAS goes Community Edition

⚠️ BREAKING: The Home Assistant domain changes (truenas → truenas_ce)

After updating you must add TrueNAS CE once — host, API key, options and all entities including their history are migrated automatically, and the old integration is automatically disabled (not deleted).
➡️ Full details & step-by-step guide in the migration note: docs/migration.md.

The big cut: the integration becomes independent and is now called TrueNAS CE — with a seamless, history-preserving migration and new dataset features.

✨ New Features

• Independent project & new domain: standalone project; HA domain truenas → truenas_ce. Display name is now TrueNAS CE.
• Seamless one-click migration: when adding TrueNAS CE, host, API key, options AND all entities including their history + long-term statistics are adopted automatically (permutation-safe entity_id adoption). Success notification + .storage backup beforehand.
• Safe rollback: a diagnostic button opens a Repairs confirmation dialog that undoes the migration — as long as the old integration is still installed.
• Lock & unlock encrypted datasets (#53): dataset_lock/dataset_unlock actions + Encrypted, Locked and Encryption-key-format attributes.

🛠️ Core & Stability Improvements

• Release pipeline on Node 24 (upload action pinned by SHA).
• Curated release notes are preserved (#52).

🐛 Bug Fixes & Refactoring

• Robust lock/unlock: wrong passphrases surface as a clear error; lock/unlock on non-encrypted datasets is rejected up front.

⚠️ Requirements & Notes

• Breaking — domain change: after updating, add TrueNAS CE once; the old integration is disabled automatically (not deleted). Guide: docs/migration.md.
• ⭐ Please re-star: the repository was re-created as a standalone (non-fork) project — old stars stay on the legacy repo and do not carry over.
• Requirements: Home Assistant 2024.8.0+, TrueNAS 25.04+.