Sensors

TrueNAS

tomaae/homeassistant-truenas · vv1.3.1

HACSLocal polling

TrueNAS integration for Home Assistant

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)

What people report

Local polling of TrueNAS systems. Version 1.4 works with TrueNAS 25 only; 1.3.x needed for TrueNAS 24 and older, and FreeNAS is effectively unsupported.

Works3
Partly works1
Won’t be supported1

Device	In Home Assistant	What they said	Source
Legacy FreeNAS boot pool	Works Local	Fixed locally by contributor; works on newer TrueNAS Scale Saved copy This is an old(er) system, installed during the FreeNAS days. The boot pool is called freenas-boot what is most likely causing this issue. This does work very well on a new(er) TrueNAS Scale system. ``` # zfs list \| grep boot freenas-boot 29.1G 28.5G 64K none freenas-boot/.system 762M 28.5G 3.06M legacy freenas-boot/.system/configs-bd646a760d754b2abf350a01716f52a4 128M 28.5G 128M legacy freenas-boot/.system/cores 25K 1024M 25K legacy freenas-boot/.system/rrd-bd646a760d754b2abf350a01716f52a4 618M 28.5G 618M legacy freenas-boot/.system/samba4 1.50M 28.5G 120K legacy … Excerpt saved from GitHub on 2026-10-23.	Issue #37 · 2022-08
TrueNAS 25.10	Works Local	Needs integration 1.4 Saved copy API key is using root as the user. But I also tried with truenas_admin. hacs: integration truenas" Excerpt saved from GitHub on 2026-10-23.	Issue #343 · 2026-07
TrueNAS Scale 22.12	Works Local	Works; sensor names display fixed after update Saved copy They seem to be created correctly ``` 2023-07-28 13:00:58.487 DEBUG (MainThread) [custom_components.truenas.model] Updating entity TrueNAS-disk-nvme1n1 2023-07-28 13:00:58.487 DEBUG (MainThread) [custom_components.truenas.model] Updating entity TrueNAS-disk-sdb 2023-07-28 13:00:58.487 DEBUG (MainThread) [custom_components.truenas.model] Updating entity TrueNAS-disk-sdc 2023-07-28 13:00:58.488 DEBUG (MainThread) [custom_components.truenas.model] Updating entity TrueNAS-disk-sdf 2023-07-28 13:00:58.488 DEBUG (MainThread) [custom_components.truenas.model] Updating entity TrueNAS-disk-sdd … Excerpt saved from GitHub on 2026-10-23.	Issue #91 · 2023-07
TrueNAS 24.10 (Electric Eel)	Partly works Local	Integration 1.4 incompatible; use 1.3.1 or upgrade to TrueNAS 25 Saved copy Describe the issue Trying to add my truenas ## How to reproduce the issue N/A ## Expected behavior simply add the truenas ## Screenshots ## Software versions - Home Assistant version: CORE 2025.6.1 / supervisor 2025.05.5 - TrueNAS integration version: V1.4b2 - TrueNAS version: ElectricEel-24.10.2.2 ## Traceback/Error logs Logger: aiohttp.server Source: /usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py:481 First occurred: 9:53:42 PM (2 occurrences) Last logged: 9:53:46 PM Error handling request from 192.168.2.11 Traceback (most recent call last): File … Excerpt saved from GitHub on 2026-10-23.	Issue #253 · 2025-06
FreeNAS	Won’t be supported	Maintainer says no version will work with FreeNAS Saved copy … version would have downloaded instead of 1.3. My bad! It is working very nicely. BTW. 1.4 is still in pre-release status... I am upgrading from an old FreeNAS. Can this integration work with that old system? Excerpt saved from GitHub on 2026-10-23.	Issue #343 · 2026-07

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local polling

Talks to the device on your network, asking it for updates every so often.

Details

Installs (analytics)	2,096 (0.3%)
GitHub stars	386
Latest version	v1.3.1 (2026-08-05)
Set up in the UI	Yes
Maintainers	@tomaae
License	Apache-2.0

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

Fork	Stars	Last push	Description
kayl-codes/homeassistant-truenas-legacy	★ 9	2026-06-23	⚠️ MOVED → now developed as TrueNAS CE at kayl-codes/homeassistant-truenas. This repo is read-only/legacy.
cyr-ius/hass-truenas	★ 8	2026-10-10	Truenas integration for Home Assistant

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/tomaae/homeassistant-truenas
Source code: https://github.com/tomaae/homeassistant-truenas
Issues: https://github.com/tomaae/homeassistant-truenas/issues
HACS: https://hacs.xyz