--- title: "UniFi WAN" description: "UniFi WAN is a Marketplace integration for Home Assistant. It has 139 installs sharing analytics, works locally and was last updated November 6, 2026." canonical: "https://vulpo.app/integrations/marketplace/holdestmade-unifi-wan" url: "https://vulpo.app/integrations/marketplace/holdestmade-unifi-wan.md" last-updated: "2026-11-08" version: "1.4" --- # UniFi WAN > UniFi WAN is a Marketplace integration for Home Assistant. It has 139 installs sharing analytics, works locally and was last updated November 6, 2026. UniFi WAN is a Marketplace integration that pulls WAN metrics from a local UniFi OS console. It adds sensors for WAN status, IPv4 and IPv6 addresses, and download and upload rates, with one rate set refreshed on a fast interval and another on the scan interval. Speedtests can run automatically on a set interval or be started manually through an action, and binary sensors follow the test lifecycle. Each speedtest also records the server and the ISP details for the WAN. Expected download and upload speeds can be entered with a tolerance, and status sensors then report whether a test came out as Expected, Faster or Slower. Setup happens in the UI with the console address and an API key, and a diagnostics download and a raw data dump are available for troubleshooting. Automatic summary of the README and code of holdestmade/Unifi-WAN. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/support) [Open in My Home Assistant](https://my.home-assistant.io/redirect/marketplace_repository/?owner=holdestmade&repository=Unifi-WAN&category=integration) On Home Assistant 2026.10 or older? [Open it in HACS](https://my.home-assistant.io/redirect/hacs_repository/?owner=holdestmade&repository=Unifi-WAN&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### UniFi WAN - **Host / IP** - **API Key** - **Site** - **Verify SSL Certificate** - **Run Speedtest Automatically** - **Auto Speedtest Interval (minutes)** ### Re-authenticate UniFi WAN - **API Key** ### Reconfigure UniFi WAN - **Host / IP** - **API Key** - **Site** - **Verify SSL Certificate** ### After setup - **Host / IP** - **API Key (leave blank to keep current)** - **Site** - **Verify SSL Certificate** - **Scan Interval (seconds)** - **Rate Interval (seconds, 0 to disable)** - **Run Speedtest Automatically** - **Auto Speedtest Interval (minutes)** - **ISP Expected Download Speed (Mbit/s, 0 to disable)**: What your line is sold as. The ISP Download Speed Status sensor compares each speedtest against it and reports Expected, Faster or Slower. Leave at 0 if you would rather not compare. - **ISP Expected Upload Speed (Mbit/s, 0 to disable)**: What your line is sold as. The ISP Upload Speed Status sensor compares each speedtest against it and reports Expected, Faster or Slower. Leave at 0 if you would rather not compare. - **ISP Speed Tolerance (%)**: How far either side of the expected speed still counts as meeting it. At 2%, a 500 Mbit/s line reads Expected between 490 and 510. Widen it for a connection that varies by time of day; 0 means only an exact match counts. Texts from the code of [holdestmade/Unifi-WAN](https://github.com/holdestmade/Unifi-WAN). ## Actions - **Run Speedtest**: Trigger a manual speedtest on the active UniFi Gateway immediately. Fields: WAN interface - **Dump raw data**: Write an unredacted JSON file of everything the controller returns, to config/unifi\_wan\_dumps/, for your own inspection. Contains IP addresses, MAC addresses, serial numbers and the ISP lookup - do not post it publicly; use Download diagnostics for that. Fields: Files to keep ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > Pull WAN metrics from a UniFi OS console. > > (UDM / UDR / UXG (with a separate cloud key) / UGW / EFG / UCG-Ultra etc.) > > - Live WAN status, IP information and throughput sensors > - Speedtest automation with manual triggers and binary sensors for insight into the test lifecycle > - Speedtest server identification per WAN — which provider, host and location the test ran against > - ISP identification per WAN — provider, organisation, ASN and location, from the lookup the gateway performs against each WAN's own public address > - Redacted diagnostics for bug reports, and unredacted raw JSON dumps for looking at your own data From the README of [holdestmade/Unifi-WAN](https://github.com/holdestmade/Unifi-WAN#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), Routers and network - Brand: [Ubiquiti](https://vulpo.app/integrations/ubiquiti.md) - Number: 139 installs sharing analytics; 35 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.12.3, last updated November 6, 2026 - Domain: `unifi_wan` - Source: - Issues: In Vulpo: Quick Toggle card, Button card, Chart card, Apple Watch, Control Center ## Other ways in for Ubiquiti | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [UniFi Network](https://vulpo.app/integrations/core/unifi.md) | Built-in integration | 43.7k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Protect](https://vulpo.app/integrations/core/unifiprotect.md) | Built-in integration | 25.9k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Access](https://vulpo.app/integrations/core/unifi-access.md) | Built-in integration | 1.7k installs sharing analytics | Works locally | Part of Home Assistant | | [Unifi Access](https://vulpo.app/integrations/marketplace/imhotep-hass-unifi-access.md) | Marketplace integration | 698 installs sharing analytics | Works locally | Updated in the last 6 months | | [UniFi Network Map](https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha.md) | Marketplace integration | 522 installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-11-08. Source: https://vulpo.app/integrations/marketplace/holdestmade-unifi-wan --- - HTML version of this page: https://vulpo.app/integrations/marketplace/holdestmade-unifi-wan - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml