⚠️ Deprecated & archived — use SlyBase instead

This fork is no longer maintained and has been archived.

Please use the actively-maintained, modernized successor, which descends from this fork (it forked from here) and reimplements everything on a coordinator-based architecture with tests, a Repairs flow, selective per-resource monitoring and support for current Home Assistant versions:

👉 SlyBase/homeassistant-openmediavault

---

OpenMediaVault integration for Home Assistant

Monitor your OpenMediaVault 5/6 NAS from Home Assistant.

Features:

• Filesystem usage sensors
• System sensors (CPU, Memory, Uptime)
• System status sensors (Available updates, Required reboot and Dirty config)
• Disk and smart sensors
• Service sensors

Features

Filesystem usage

Monitor your filesystem usage.

System

Monitor your OpenMediaVault system.

Disk smart

Monitor your disks.

Install integration

This integration is distributed using HACS.

You can find it under "Integrations", named "OpenMediaVault"

Setup integration

Setup this integration for your OpenMediaVault NAS in Home Assistant via Configuration -> Integrations -> Add -> OpenMediaVault. You can add this integration several times for different devices.

• "Name of the integration" - Friendly name for this NAS
• "Host" - Use hostname or IP
• "Use SSL" - Connect to OMV using SSL
• "Verify SSL certificate" - Validate SSL certificate (must be trusted certificate)

Development

Translation

To help out with the translation you need an account on Lokalise, the easiest way to get one is to click here then select "Log in with GitHub". After you have created your account click here to join OpenMediaVault project on Lokalise.

If you want to add translations for a language that is not listed please open a Feature request.

Enabling debug

To enable debug for OpenMediaVault integration, add following to your configuration.yaml:

logger:
  default: info
  logs:
    custom_components.openmediavault: debug

Changes in this fork

This version includes several changes and improvements over the original repository.

New Sensors

GPU Sensors

This integration now provides sensors to monitor your GPU.

Sensor ID	Name	Unit
system_gpuUtilization	GPU load	%
system_gpu_freq_cur	GPU Current Frequency	MHz
system_gpu_freq_max	GPU Max Frequency	MHz

RAID Sensor

A new sensor is available to monitor the health of your RAID arrays.

Sensor ID	Name	Attributes
raid	(Name of the RAID device)	state, level, health_indicator, action_percent

Merged Pull Requests

This version incorporates the following pull requests from the original repository:

• Temperature and CPU Fix
• Add SMART overall drive health to "disk" entry

Bug Fixes

Stale per-container entities

Per-container sensors (one entity per Docker container) were never removed when a container was deleted. Each orphaned entity then raised a KeyError on every update cycle, which could also desync the Home Assistant recorder (StaleDataError) and freeze history graphs.

This fork now:

• marks an entity unavailable instead of crashing when its container is gone, and
• automatically prunes per-container entities once their container disappears (system sensors are never touched).

Prerequisites

This integration relies on information from the following system files:

• /sys/class/drm/card*/device/gpu_busy_percent for GPU utilization.
• /sys/class/drm/card*/gt_cur_freq_mhz for GPU current frequency.
• /sys/class/drm/card*/gt_max_freq_mhz for GPU max frequency.
• /proc/mdstat for RAID status.

Docker

When running Home Assistant in a Docker container, you must expose these files and directories from the host to the container for the integration to work correctly.

• For GPU monitoring, you need to mount the /sys/class/drm directory.
• For RAID monitoring, you need to mount the /proc/mdstat file.

Example docker run command:

docker run ... -v /sys/class/drm:/sys/class/drm:ro -v /proc/mdstat:/proc/mdstat:ro ...

Example docker-compose.yml:

services:
  homeassistant:
    ...
    volumes:
      - /sys/class/drm:/sys/class/drm:ro
      - /proc/mdstat:/proc/mdstat:ro
    ...