Libre Hardware Monitor
The Libre Hardware Monitor integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] uses your Libre Hardware Monitor installation as a source for sensors to display that system information in Home Assistant.
Libre Hardware Monitor, a fork of Open Hardware Monitor, is free software that can monitor the temperature sensors, fan speeds, voltages, load and clock speeds of your computer.
Use this integration to keep an eye on your computer from anywhere, for example while gaming or running heavy workloads. You can also use it to get notified when a value crosses a threshold, such as a GPU running hot.
Supported devices
Any hardware that Libre Hardware Monitor detects is supported, such as CPUs, GPUs, motherboards, memory, storage drives, and network adapters.
Prerequisites
- Libre Hardware Monitor version 0.9.5 or later is installed on the system (host) you want to monitor. Earlier versions are not supported. You can download the latest release from the Libre Hardware Monitor releases page.
- Libre Hardware Monitor must be running during setup.
- In Libre Hardware Monitor, make sure Options > Remote web server > Run is active.
- Optionally, set up authentication for the web server. You might have to restart the server for this to take effect.
- Make sure to open the inbound port (8085 by default) on the host system’s firewall.
- In Libre Hardware Monitor, go to File > Hardware and check the devices you want to monitor.
To open a port (on Windows Firewall)
- In Windows, navigate to Control Panel > System and Security > Windows Defender Firewall.
- Select Advanced settings and highlight Inbound Rules in the left pane.
- Right-click Inbound Rules and select New Rule.
- Add the port you need to open and select Next.
- Add the protocol (TCP) and the port number (8085 by default) into the next window and select Next.
- In the next window, select Allow the connection, then select Next.
- Select the network type as you see fit and select Next.
- Name the rule and select Finish.
Configuration
To add the Libre Hardware Monitor device to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Libre Hardware Monitor.
-
Follow the instructions on screen to complete the setup.
Configuration options
The integration provides the following configuration options only if authentication is required:
Supported functionality
The integration mirrors all hardware and sensors that Libre Hardware Monitor shows for the monitored system.
- Each hardware component, such as the CPU or a drive, becomes a device in Home Assistant. The device name starts with the computer name, for example
[MY-PC] NVIDIA GeForce RTX 4080. - Each sensor of that hardware becomes a sensor entity, for example temperatures, loads, clock speeds, fan speeds, voltages, power, and data sizes.
- Each sensor has the Min value and Max value attributes, which show the lowest and highest values recorded by Libre Hardware Monitor.
- When you add or remove hardware in Libre Hardware Monitor (File > Hardware), the matching devices are added to or removed from Home Assistant automatically.
If you do not require all sensors of a device, you can disable the corresponding entities in the UI.
Automation examples
Below are example automations to get notified when something needs your attention.
You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the visual automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.
Automation: Get notified when your GPU is too hot
This automation sends a notification to your phone when the GPU temperature goes above 95 °C.
-
Trigger: Temperature crossed threshold
-
Target: GPU Core (
sensor.my_pc_nvidia_geforce_rtx_4080_gpu_core_temperature) - Threshold type: Above (95 °C)
-
Target: GPU Core (
-
Action: Send a notification message
-
Target: My Device (
notify.my_device) - Message: Your GPU temperature is above 95 °C.
-
Target: My Device (
YAML example for a GPU temperature alert
alias: "Notify when the GPU exceeds safe temperature"
triggers:
- trigger: temperature.crossed_threshold
target:
entity_id: sensor.my_pc_nvidia_geforce_rtx_4080_gpu_core_temperature
options:
threshold:
type: above
value:
number: 95
unit_of_measurement: "°C"
actions:
- action: notify.send_message
target:
entity_id: notify.my_device
data:
message: "Your GPU temperature is above 95 °C."
Automation: Get notified when a drive is almost full
This automation sends a notification to your phone when the free space on an NVMe drive drops below 100 GiB. The Below value uses the unit the sensor is displayed in, which is GiB by default.
-
Trigger: Numeric state
-
Entity: Free disk space (
sensor.my_pc_samsung_ssd_990_pro_2tb_free_space_data) - Below: 100
-
Entity: Free disk space (
-
Action: Send a notification message
-
Target: My Device (
notify.my_device) - Message: Your NVMe drive has less than 100 GiB of free space left.
-
Target: My Device (
YAML example for a low disk space alert
alias: "Notify when a drive is almost full"
triggers:
- trigger: numeric_state
entity_id: sensor.my_pc_samsung_ssd_990_pro_2tb_free_space_data
below: 100
actions:
- action: notify.send_message
target:
entity_id: notify.my_device
data:
message: "Your NVMe drive has less than 100 GiB of free space left."
Data updates
The integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from Libre Hardware Monitor every 10 seconds.
When the monitored system is not reachable, for example because it is turned off, its sensors change to unavailable. They resume updating once the system is reachable again. If you want to be notified when the connection is lost, create an automation that triggers when a sensor changes to unavailable.
Known limitations
- If Home Assistant starts while the monitored system is offline, the integration shows an error state. It recovers automatically once the system is reachable again.
- A lost connection to the monitored system is not logged as an error, because computers are usually not online all the time.
Troubleshooting
Problem with connection during setup
Check if the Libre Hardware Monitor remote web server is running and accessible.
On a device that is not the device running Libre Hardware Monitor (a smartphone is sufficient), open a browser and navigate to http://<IP address>:<Port>.
Make sure you can see and refresh the data there.
Libre Hardware Monitor version is not supported
During integration setup, the form might show this message:
Your version of Libre Hardware Monitor is no longer supported. Please update to version 0.9.5 or later.
Note that Libre Hardware Monitor versions before 0.9.5 do not provide stable sensor data. The integration does not support these versions.
Resolution
- Download version 0.9.5 or later from the Libre Hardware Monitor releases page.
- On the system you want to monitor, close Libre Hardware Monitor.
- Install or extract the new version, then start Libre Hardware Monitor again.
- Check that Options > Remote web server > Run is still active. You might have to enable it again.
- In Home Assistant, set up the integration again. If it was set up before, go to Settings > Devices & services, select Libre Hardware Monitor, and select Reload.
Integration stops working
Make sure the IP address of the system you are monitoring has not changed. Ideally, set a static IP address for that system in your router.
Removing the integration
This integration follows standard integration removal.
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- Next to the entry you want to remove, select the three dots
menu. Then, select Delete. - Depending on the integration, the entries are listed under one of the following headings:
- Devices
- Hubs
- Services
- Integration entries
- Depending on the integration, the entries are listed under one of the following headings:
- To confirm, select Delete.
- Home Assistant also deletes the devices and entities of the entry.
- If Home Assistant asks you to restart, restart Home Assistant.
- If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
- If you keep them, Home Assistant uses them automatically when you add the integration again.
- To delete them later, refer to Deleting application credentials.