2025.06.11

Release 2025.06.11

Bug Fixes

• Enhance UPS energy sensor to restore previous state and improve energy calculation logic

2025.06.10

Release 2025.06.10

Bug Fixes

• Fixed UPS Total Power Consumption Sensor
• Fixed Array Health Sensor

2025.06.09

Release 2025.06.09

Improvements

• RAM Usage Sensor:
  • Added extra attributes for System, VM, ZFS cache, Docker and Free Memory utilisation.
• CPU Usage Sensor:
  • Added extra attributes for CPU Load (1m), CPU Load (5m),CPU Load (15m) #29

Bug Fixes

• Fixed detection of multiple pools #83

2025.06.05

Release 2025.06.05

Overview

This release introduces significant hardware monitoring enhancements, improved entity management, and addresses critical issues reported after the v2025.06.02 release. Focus areas include Intel GPU monitoring, RAID controller detection, enhanced fan detection, and improved VM entity handling.

New Features

• Intel GPU Monitoring: Added comprehensive Intel GPU sensor with power draw, frequency, and memory bandwidth monitoring
• RAID Controller Detection: Implemented automatic RAID controller detection and monitoring capabilities
• CPU Power Monitoring: Enhanced CPU power monitoring features for better system insights
• Enhanced USB Device Detection: Improved USB flash drive detection with device type classification and SMART support detection
• Advanced Fan Hardware Detection: Enhanced fan detection with optimized caching and improved diagnostic logging

Improvements

• VM Entity Management:

  • Enhanced VM entity ID generation to ensure uniqueness and handle collisions
  • Improved entity persistence across integration restarts
  • Better handling of VM state changes and naming conflicts

• Hardware Monitoring Enhancements:

  • Added device_type and supports_smart attributes to USB device information
  • Improved USBFlashDriveDetector for better device classification
  • Enhanced array status binary sensor with user-friendly formatting
  • Optimized fan hardware detection with improved caching mechanisms

• Error Handling & Logging:

  • Improved error logging for batched disk info commands with better None exit status handling
  • Enhanced diagnostic logging throughout hardware detection processes
  • Better error reporting for disk operations and SMART data retrieval

• Sensor Improvements:

  • Replaced memory usage sensor with Intel GPU sensor for better hardware monitoring
  • Enhanced array disk and pool disk sensors with consistent attribute naming
  • Improved storage attribute formatting in DiskDataHelperMixin

Bug Fixes

• Fixed VM entity issues after v2025.06.02 update - Addresses #84
• Resolved missing sensors and attributes - Addresses #83
• Enhanced USB flash drive detection reliability
• Improved error handling for disk information commands
• Fixed entity ID collisions in VM management
• Better handling of hardware detection edge cases

Hardware Support Enhancements

• Intel GPU Support: Full monitoring of Intel integrated graphics including power and performance metrics
• RAID Controller Detection: Automatic detection and monitoring of hardware RAID controllers
• Enhanced USB Detection: Better classification and monitoring of USB storage devices
• Improved Fan Monitoring: More reliable fan detection with optimized performance

Notes

• This release focuses heavily on hardware monitoring improvements and entity management
• Intel GPU monitoring provides valuable insights for systems with integrated graphics
• Enhanced USB detection improves support for various flash drive types and configurations
• VM entity improvements resolve issues reported after the previous release
• All new hardware monitoring features are automatically enabled when compatible hardware is detected

2025.06.02

Release 2025.06.02

🔍 Overview

This release focuses on documentation improvements, enhanced user experience, important bug fixes, and addresses several community-reported issues for the Unraid integration.

✨ New Features

• Beta GraphQL Integration Available: Added information about the new Unraid Connect integration that uses Unraid's official GraphQL API
• Enhanced USB Flash Drive Detection: Improved detection and handling of USB flash drives
• Improved Temperature Conversion Logic: Better temperature handling and conversion across different sensor types
• Disk Update Interval Configuration: Added support for configurable disk update intervals in minutes instead of hours

🛠️ Improvements

• Documentation Overhaul:

  • Updated all documentation links to point to the new GitHub Pages site: https://domalab.github.io/ha-unraid/
  • Added DeepWiki badge for enhanced community support
  • Standardized badge styling across README.md for consistent visual appearance
  • Enhanced documentation structure with improved navigation and content organization

• User Experience Enhancements:

  • Added detailed CPU information including cores, model, and architecture
  • Improved disk data attributes with more intuitive naming and capacity utilization descriptions
  • Enhanced Docker container sensor attributes for better readability and health status
  • Updated network sensor attributes with user-friendly formatting and total bytes transferred
  • Improved UPS sensor attributes with detailed battery and load status descriptions
  • Added Array Status binary sensor for better system monitoring

• Code Quality & Maintainability:

  • Implemented cleanup for duplicate entities to prevent duplication during restarts
  • Enhanced error handling and logging throughout the integration
  • Refactored code structure for improved readability and maintainability
  • Updated strings and translations for better clarity during setup
  • Removed legacy compatibility layers and streamlined integration architecture

🐛 Bug Fixes

• Fixed USB flash drive detection issues
• Improved temperature sensor reliability - Fixes #59
• Enhanced entity naming consistency
• Better handling of duplicate entities during integration restarts - Addresses #81, #60
• Fixed parity history parsing errors - Closes #39, #38, #69
• Improved network operations error handling - Addresses #56
• Fixed datetime module attribute errors - Closes #59
• Enhanced hostname handling and entity naming conventions

📋 Migration & Compatibility

• Migration Handling: Implemented proper migration handling for config entries with rollback support
• Backward Compatibility: This update maintains backward compatibility with existing configurations
• Entity Cleanup: Automatic cleanup of duplicate entities to prevent issues during restarts
• No Configuration Changes Required: Existing installations will continue to work without manual intervention

🔗 Issues Addressed

This release addresses several community-reported issues:

• Closes #59 - Fixed datetime module attribute errors in temperature detection
• Closes #39 - Resolved parity history parsing errors with invalid literals
• Closes #38 - Fixed parity history parsing for records with insufficient fields
• Closes #69 - Improved parsing for speeds and dates with locale-specific formatting
• Addresses #81 - Enhanced duplicate entity handling during restarts
• Addresses #60 - Improved entity persistence across HA restarts
• Addresses #56 - Better error handling for network operations
• Addresses #77 - Added configurable disk update intervals (minutes instead of hours)

📝 Notes

• The integration now includes information about the beta GraphQL-based integration for users interested in trying the new approach
• Documentation has been moved to GitHub Pages for better accessibility and maintenance
• All badge styling has been standardized for a cleaner, more professional appearance
• Enhanced error handling reduces log spam and improves system stability

For detailed documentation and setup instructions, visit our Documentation Site.

2025.01.08

🔍 Overview

This release includes several important bug fixes.

🐛 Bug Fixes

• Fix for issue #36 regarding missing VM and Container switches on Unraid versions 6.12.x.
• Fix for issue #38 regarding Parity Check Status Sensor not detecting all fields in /boot/config/parity-check.log. if you see this in your logs its normal Skipping invalid date: 1969 ...
• Fix for issue #37 regarding SpinDownDelay error from HA logs by @ond000 in #47
• Fix for issue #51 regarding Error checking disk state for /dev/nvme0n1p1
• Fix for issue #43 regarding CPU Temp not working on certain chipsets that was missing from detection logic in the code.
• Fix for issue #37 regarding pool device named temp from being detected. Custom pool names by the name of temp is now detected.

🛠 Other Improvements

• Changed naming on UPS sensors to now display UPS Current Consumption, UPS Current Load and UPS Total Consumption

New Contributors

• @ond000 made their first contribution in #47

📝 Notes

Docker Insights (Beta) feature now removed due to causing HA instability issues and dependency on dockersocket proxy container

2024.12.28

🔍 Overview

This release includes several important enhancements and bug fixes for the Unraid integration, aimed at improving monitoring, performance, and overall user experience.

✨ New Features

• System Fan Sensors: Gain insights into your server’s cooling performance with basic system fan sensors.
• Parity Health Monitoring: Easily view parity health status directly within Home Assistant.
• Pool Usage & Custom Pool Disk Names: Monitor pool usage and take advantage of custom disk naming to keep your storage organized.
• Docker Insights (Beta): Get in-depth container statistics through Docker Insights (requires Dockersocket container to be installed on your Unraid server).

🐛 Bug Fixes

Entity Naming Schema & Unique IDs:

• Fixed issues causing entity naming conflicts and improved uniqueness to avoid duplication.

Network Traffic Calculations:

• Resolved inaccuracies in inbound/outbound traffic calculations for network interfaces.

🛠 Other Improvements

Improved Disk Mappings:

• Enhanced logic to more accurately map and identify disks.
• Reduced SSH Calls:
• Optimized the integration to minimize the number of SSH connections required to communicate with the Unraid server.

📝 Notes

Important: Due to the scope of these updates, you may need to reinstall the integration and clear your browser cache for everything to work smoothly. There is a high chance that your existing entities will not be migrated across and any automations will be affected.

2024.11.15

🔍 Overview

This update introduces significant improvements and new features for the Unraid integration, enhancing functionality and usability.

---

✨ New Features

• Configurable Update Intervals:

  • General sensors (CPU, Motherboard) now have adjustable update intervals during setup, ranging from 1 to 60 minutes.
  • Disk sensors update intervals are configurable during setup, ranging from 1 to 24 hours.

• UPS Power Monitoring:

  • New sensors added to track UPS metrics such as current power, energy consumption, and load percentage.

• Network Traffic Monitoring:

  • Added sensors to monitor inbound and outbound network traffic.

• Parity Check Sensor:

  • Monitor array parity checks directly in Home Assistant.

• Disk Health Monitoring:

  • New sensors track drive temperatures and health statuses.

• Diagnostics Enhancement:

  • UPS status information has been relocated to the diagnostics section for better organization.

---

🐛 Bug Fixes

• Fixed issues with executing service commands.
• Improved support for CPU and Motherboard sensors across a broader range of systems.
• Removed automatic UPS detection; UPS sensors must now be explicitly enabled.
• Enhanced UPS sensor functionality to gracefully handle systems without a connected UPS.
• Fixed special characters with VMs not being recognised by VM controls

---

🛠 Other Improvements

• Refined naming conventions and formatting for better consistency.
• Updated versioning style to align with Home Assistant standards.

---

📝 Notes

• Important: Due to the scope of these updates, you may need to reinstall the integration and clear your browser cache for everything to work smoothly.

v0.1.5

Release v0.1.5

🔍 Overview

This release brings a small improvements to the Unraid integration, focusing on enhanced diagnostic logging.

✨ New Features

• Added diagnostic sensors and ability to download diagnostics file for troubleshooting purposes

📝 Notes

• This update maintains backward compatibility with existing configurations
• No configuration changes required for existing installations

v0.1.4

Release v0.1.4

🔍 Overview

This release brings significant improvements to the Unraid integration, focusing on enhanced Docker container and VM management, better state tracking, and improved error handling.

✨ New Features

• Added improved Docker container state tracking with detailed status information
• Enhanced VM state detection with better OS type recognition (Windows/Linux)
• Added dynamic icons for VMs based on OS type (Windows/Linux)
• Added additional container and VM attributes for better monitoring

🛠️ Improvements

• Improved Docker container start/stop operations reliability
• Enhanced state synchronization between Unraid and Home Assistant
• Better error handling and logging for troubleshooting
• Added more detailed entity attributes for both Docker containers and VMs
• More robust parsing of container and VM states

🐛 Bug Fixes

• Fixed VM state tracking when turned off from Unraid
• Fixed Docker container state synchronization issues
• Fixed JSON parsing errors in container information retrieval
• Fixed state attribute errors in entity updates

💡 Technical Details

• Implemented proper state enum classes for both VMs and Docker containers
• Enhanced error handling in SSH command execution
• Improved data structure for container and VM information
• Added debug logging for better troubleshooting

📝 Notes

• This update maintains backward compatibility with existing configurations
• No configuration changes required for existing installations
• Improved reliability for both Docker container and VM management