pfSense
travisghansen/hass-pfsense · vv0.6.7
pfSense integration with 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 |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
pfSense/Netgate firewalls work locally but large installs time out and entities go unavailable; traffic sensors show wrong or swapped values for some users.
- Works1
- Partly works3
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| pfSense on FreeBSD 12.3 (2.6.0-devel) | Works Local | PHP crash on FreeBSD 12.3 fixed on mainSaved copyHello, amd64 12.3-PRERELEASE FreeBSD 12.3-PRERELEASE devel-12-n226715-1de26c41319 pfSense [IN PFSENSE] a lot of these PHP crashes: Crash report details: ``` PHP Errors: [13-Nov-2021 23:18:29 Europe/Vilnius] PHP Warning: Use of undefined constant ifdescr - assumed 'ifdescr' (this will throw an Error in a future version of PHP) in /usr/local/www/xmlrpc.php(147) : eval()'d code on line 118 [13-Nov-2021 23:18:29 Europe/Vilnius] PHP Warning: Use of undefined constant ifdescr - assumed 'ifdescr' (this will throw an Error in a future version of PHP) in /usr/local/www/xmlrpc.php(147) : eval()'d code … Excerpt saved from GitHub on 2026-10-23. | Issue #33 · 2021-11 | |
| Complex pfSense install (many VLANs, packages) | Partly works Local | All entities go unavailable when toggling rules due to slow data fetch timeoutSaved copyHello, I would say I do have a complex pfSense install. Multiple networks, interfaces, vlans, service, packages, firewall rules, etc. Still only average 30% memory use (of 8GB) and current load averages show: 0.71, 0.55, 0.45 Bandwidth does not seem to be the issue as I am barely utilizing the available. This is not being polled via WAN. Let me know if you need any more info. Excerpt saved from GitHub on 2026-10-23. | Issue #19 · 2021-11 | |
| Netgate 3100 (pfSense) | Partly works Local | WAN inbytes sensor shows impossibly high valuesSaved copyI have a Netgate 3100. Its WAN interface lists as `1000baseT `, but I regularly see values for `sensor.my_router_name_interface_wan_inbytes_kilobytes_per_second` around 300,000 kBps, which is about 2.35Mbps, exceeding what my WAN interface can handle. It is, however, within the limits of the LAN interface, listed at `2500Base-KX `. Is it possible that the sensor is reading the LAN interface values instead of the WAN interface values? Excerpt saved from GitHub on 2026-10-23. | Issue #108 · 2022-10 | |
| pfSense with VLAN interfaces | Partly works Local | In/out bytes appear swapped on local VLAN interfacesSaved copyI noticed the values for inbytes/outbytes on my LAN VLAN interfaces are swapped around compared to the pfsense web traffic graph. I'm currently moving files from one VLAN to another and noticed the values on my dash were appearing in the opposite direction. After checking, ALL reported traffic is swapped in HA sensors for local interfaces, such as traffic from WAN to a VLAN. Debug logging didn't show anything. I have checked I labeled the correct sensors, Received is `inbytes` and Transmit is `outbytes`. My local VLAN interfaces appear affected, but NOT my WAN interface. Such that WAN … Excerpt saved from GitHub on 2026-10-23. | Issue #156 · 2023-04 |
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) | 1,143 (0.16%) |
|---|---|
| GitHub stars | 247 |
| Latest version | v0.6.7 (2026-07-25) |
| Set up in the UI | Yes |
| Maintainers | @travisghansen |
| License | Apache-2.0 |
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/travisghansen/hass-pfsense
- Source code: https://github.com/travisghansen/hass-pfsense
- Issues: https://github.com/travisghansen/hass-pfsense/issues
- HACS: https://hacs.xyz