OpenWrt for Home Assistant (Marketplace integration)

Installs: 457 sharing analytics
GitHub stars: 123
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2.5.3, October 26, 2026
Category: Computers and network, Routers and network
Kind: Marketplace integration
Brand: OpenWrt
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: openwrt
Source: github.com/FaserF/ha-openwrt
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

OpenWrt is a Home Assistant integration that monitors and controls OpenWrt routers locally. It talks to the router through the native OpenWrt Ubus interface, or over SSH, rather than SNMP or ping checks. It adds device tracking, system sensors for CPU, memory, load, uptime and temperature, plus switches and buttons for radios, WPS, services, internet access and backups. Further coverage includes VPN status for WireGuard and OpenVPN, multi-WAN, and cellular modem signal readings. Firmware updates, including custom firmware, are exposed as update entities, and actions can run shell commands, read or set router configuration values, and generate a report. Optional MQTT presence detection is available, and the integration is set up in the UI, with discovery on the network.

Automatic summary of the README and code of FaserF/ha-openwrt. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Lights
Switches
Sensors
Presence

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

OpenWrt Setup Wizard

Connection Type
Setup Mode

Authentication

Username
Password
Use SSL/HTTPS
Verify SSL Certificate
Port
Ubus Path (e.g. /ubus)
DHCP Software
Ignore devices with randomized MAC addresses

Searching for OpenWrt

Continue with discovery

Select Your Router

Select Device (or enter details manually)

Manual Configuration

Host (IP address or hostname)
Connection Type

SSH Authentication

Username
Password
Private SSH Key (Optional, leaves password blank if used)
Port
DHCP Software
Ignore devices with randomized MAC addresses

Discovered OpenWrt Router

Username
Password
Use SSL (HTTPS)
Port (Optional)
DHCP Software
Ignore devices with randomized MAC addresses

Re-authenticate

Username
Password

After setup

Update Interval (seconds)
Include Wired Devices in Tracking
Device 'Consider Home' Delay (seconds)
DHCP Software
Check for firmware updates
Automatic Backup before Firmware Update
Backup retention period (days)
Custom Firmware GitHub Repo (owner/repo)
Attended Sysupgrade Server URL
Target Override (e.g. arch/subtarget)
Ignore devices with randomized MAC addresses
Enable MQTT Presence Detection
Re-deploy MQTT Presence Scripts
Re-deploy Home Assistant User & ACLs
Trust ARP 'STALE' state for presence
I have reviewed this information and want to proceed
I have reviewed this information and want to proceed
I have reviewed this information and want to proceed
Enable Device Tracking
Enable System Load Monitoring
Enable Service Monitoring & Controls
Enable Firewall Entities (Rules & Redirects)
Enable LED Controls
Enable SQM QoS Controls
Enable VPN Monitoring & Controls
Enable NLBWMon Top Hosts Sensor
Enable Snort IDS Sensor
I have reviewed this information and want to proceed
Enable MQTT Presence Detection
MQTT Broker (reachable from router)
MQTT Port
MQTT Username
MQTT Password
Target Zone Entity (e.g. Home, Office)
Root Username
Root Password

Texts from the code of FaserF/ha-openwrt.

Entities

Binary sensorsConnected, Reboot Required, Batman Mesh Active, Tailscale VPN Connected, Tailscale VPN Problem
ButtonsReboot Router, Port Forward, Internet Access, Start WPS, Cancel WPS, Disconnect device, Wake on LAN, Create Backup
EventsNew Device
LightsLED
NumbersTX Power, SQM Download Limit, SQM Upload Limit
SensorsMemory Usage, CPU Usage, Memory Used, Swap Usage, Load (1m), Connection Tracking, Load (5m), Load (15m), Uptime, Temperature, Storage Usage, Public IP, and 80 more
SwitchesWPS, Radio, Service, Internet Access, SQM Enabled, AdBlock, Simple AdBlock, Ban-IP
UpdatesFirmware, Custom Firmware

Actions

Reboot RouterReboots the OpenWrt router.Fields: Device
Execute CommandExecutes a shell command on the OpenWrt router.Fields: Device, Command
Manage ServiceManage an init.d service on the OpenWrt router.Fields: Device, Service Name, Action
Wake on LANSend a Wake on LAN magic packet to a device via the OpenWrt router.Fields: Target Router, MAC Address, Interface
UCI GetGets a UCI configuration value from the OpenWrt router.Fields: Device, Config, Section, Option
UCI SetSets a UCI configuration value on the OpenWrt router and commits the changes.Fields: Device, Config, Section, Option, Value
Create BackupGenerates a backup archive of the router configuration.Fields: Device
Generate ReportGenerates a detailed system report in markdown format.Fields: Device

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

A secure, production-ready Home Assistant integration for OpenWrt devices. Monitor system resources, track connected devices, manage WiFi radios, execute commands, and natively update firmware directly from Home Assistant.
VPN Monitoring:
Tracks status (Up/Down) for WireGuard and OpenVPN tunnels.
Monitors throughput (RX/TX) and detailed WireGuard peer statistics (handshake, transfer, allowed IPs).
Network & Connectivity:
Latency/Ping: Monitor network latency to a target (e.g. 8.8.8.8) with packet loss tracking.
DHCP Monitoring: Track the number of active DHCP leases.
Public IP: Track your external WAN IP address with change detection.
Advanced Interface Diagnostics: Individual sensors/attributes for IPv6 addresses, link speed (Mbps), duplex mode, and interface uptime.
Multi-WAN (mwan3): Per interface an online binary sensor, the online ratio since the router booted, and a status sensor with mwan3's tracking state: online, connecting (answers again, recovery…
4G/5G QModem Support (ModemManager integration):
Comprehensive signal diagnostics: RSRP, RSRQ, RSSI, SINR for LTE and 5G.
Device health: Modem temperature, voltage, and ISP detection.