About
GL.iNet Router is a Marketplace integration that connects GL.iNet routers on V4 firmware to Home Assistant. It talks to the router locally and is set up in the UI, and Home Assistant can also discover the router on the network. It adds binary sensors, buttons, selects, sensors, switches, update entities and device presence tracking. Readings cover CPU temperature, load, memory, flash, uptime, connected clients, traffic totals and cellular signal, while switches control Tailscale, WG Server, OpenVPN Server, ZeroTier, AdGuard Home and parental control. Actions send, fetch and delete SMS through the modem, manage repeater WiFi connections and saved networks, and send custom JSON-RPC or ubus requests to the router. Options include away delay, update interval, feature groups, WAN status monitoring and whitelist or blacklist handling for unknown devices.
Automatic summary of the README and code of vithurshanselvarajah/ha-glinet-router. 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
- Switches
- Sensors
- Presence
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Connect
- Router AddressType the router hostname, URL, or IP address.
- Admin PasswordEnter the admin password configured on your GL.iNet router.
- Verify SSL CertificateValidate the router's TLS certificate. Enable this only if your router uses a valid certificate.
- Away DelayNumber of seconds before a disconnected client is treated as away.
- Update IntervalNumber of seconds between polling the router for updates.
- Enabled featuresChoose the integration feature groups to set up. Disabled feature groups will not create their related entities or services.
- Monitored WAN status sensorsChoose the interface and IP version checks to monitor. Known router interface IDs are shown with friendly names, such as Ethernet 1 and Repeater. GL.iNet reports 0 as up and 1 as down.
- Discover unknown devicesAutomatically track and create entities for every device connected to the router, including those not yet integrated into Home Assistant.
- Auto-cleanup unknown devicesSet this to 0 to disable automatic cleanup. Any other number is treated as minutes; unknown discovered devices are removed after that period if they remain offline or disconnected.
- Unknown Devices Filter ModeSelect whether the list of unknown devices behaves as a whitelist or blacklist. (Blank defaults to Blacklist which won't block anything)
- Select Unknown DevicesSelect from currently discovered unknown devices to whitelist or blacklist.
- Unknown Devices Manual MAC Address List (One per line)Manually enter MAC addresses (one per line) of unknown devices to whitelist or blacklist.
- Faster updates (parallel fetching)Fetch data from all features at the same time to speed up each refresh. Off (default) is gentler on small routers.
After setup
- Router AddressType the router hostname, URL, or IP address.
- Admin PasswordEnter the admin password configured on your GL.iNet router.
- Verify SSL CertificateValidate the router's TLS certificate. Enable this only if your router uses a valid certificate.
- Away DelayNumber of seconds before a disconnected client is treated as away.
- Update IntervalNumber of seconds between polling the router for updates.
- Enabled featuresChoose the integration feature groups to set up. Disabled feature groups will not create their related entities or services.
- Monitored WAN status sensorsChoose the interface and IP version checks to monitor. Known router interface IDs are shown with friendly names, such as Ethernet 1 and Repeater. GL.iNet reports 0 as up and 1 as down.
- Discover unknown devicesAutomatically track and create entities for every device connected to the router, including those not yet integrated into Home Assistant.
- Auto-cleanup unknown devicesSet this to 0 to disable automatic cleanup. Any other number is treated as minutes; unknown discovered devices are removed after that period if they remain offline or disconnected.
- Unknown Devices Filter ModeSelect whether the list of unknown devices behaves as a whitelist or blacklist. (Blank defaults to Blacklist which won't block anything)
- Select Unknown DevicesSelect from currently discovered unknown devices to whitelist or blacklist.
- Unknown Devices Manual MAC Address List (One per line)Manually enter MAC addresses (one per line) of unknown devices to whitelist or blacklist.
- Faster updates (parallel fetching)Fetch data from all features at the same time to speed up each refresh. Off (default) is gentler on small routers.
Texts from the code of vithurshanselvarajah/ha-glinet-router.
Entities
- Binary sensorsInternet, Repeater connected, Repeater bare mode
- ButtonsReboot, Disconnect repeater, Scan WiFi networks
- SelectsWiFi network, Repeater band, Parental control group
- SensorsCPU temperature, Load avg (1m), Load avg (5m), Load avg (15m), Memory usage, Flash usage, Uptime, Connected clients, Total download, Total upload, Cellular signal, Cellular network, and 13 more
- SwitchesTailscale, Repeater auto-switch networks, Repeater bare mode, Repeater smart reconnect, WG Server, OpenVPN Server, ZeroTier, System LED, AdGuard Home, AdGuard Home DNS, Parental control, Internet access
Actions
- Send SMSSends a text message via the router modem.Fields: Recipient, Message
- Get SMSFetches the current inbox from the router.Fields: MAC address
- Refresh SMSManually triggers an SMS poll.Fields: MAC address
- Remove SMSDeletes messages from the modem.Fields: Scope, Message ID, MAC address
- Scan WiFi networksScan for available WiFi networks to connect in repeater mode.Fields: All bands, Include DFS, Refresh, MAC address
- Connect to WiFiConnect to an open or secured external WiFi network in repeater mode.Fields: SSID, Password, Remember, BSSID, MAC address
- Disconnect WiFiDisconnect from the current external WiFi network.Fields: MAC address
- Get saved networksGet list of saved WiFi networks for repeater mode.Fields: MAC address
- Remove saved networkRemove a saved WiFi network from the router.Fields: SSID, MAC address
- API PlaygroundSend a custom JSON-RPC or ubus request to the router.Fields: MAC address, Method, Body
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
Unified GL.iNet support for Home Assistant.
This integration brings GL.iNet routers into Home Assistant in a practical way. It gives you router status, device tracking, controls for common features, and optional support for VPNs, SMS, repeater mode, firewall tools, and more.
Shows in Vulpo
Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center.Information
- Installs
- 115 sharing analytics
- GitHub stars
- 40
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v1.6.5,
- Category
- Computers and network, Routers and network
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
glinet_router- Issues
- Report an issue
