Skip to content
dkwolf1 edited this page Nov 22, 2026 · 5 revisions

TP-Link Deco for Home Assistant

This wiki documents installation, configuration, entities, actions, diagnostics, and troubleshooting for the TP-Link Deco custom integration.

The stable v3.15.0 release adds manual router-log downloads and optional UDP/TCP syslog forwarding, fixes polling-switch IDs for multiple entries, and improves session cleanup. Forwarding is disabled by default; existing installations do not need to recreate their entries.

The integration connects to the local Deco web administration interface and polls Deco nodes and connected clients. Support can vary between models and firmware versions because TP-Link does not provide a stable public API for these endpoints.

Start here

  1. Read Installation before adding the integration.
  2. Use the Deco owner password with username admin. Manager credentials do not work.
  3. Enter the complete local web address, including http:// or https://.
  4. If the Deco uses a self-signed HTTPS certificate, disable Verify SSL certificate is valid.
  5. Review Configuration before changing polling or timeout settings.

Optional Lovelace dashboard card

The TP-Link Deco Lovelace card (ha-tplink-card) displays mesh topology, connected clients, throughput, Wi-Fi status, and API diagnostics in your Home Assistant dashboard. It is a separate download and uses data from your configured Deco integration.

Follow the card's installation guide to install it through Marketplace, HACS, or manually.

Wiki pages

Important security notes

  • Never post passwords, cookies, tokens, stok values, encryption keys, or complete HTTP headers.
  • Home Assistant diagnostics redact known credentials and replace client and Deco identifiers with generated IDs, but review the file before sharing it.
  • Files created by tplink_deco.download_system_log and forwarded syslog messages contain the router's own log and are not automatically redacted. They can include authentication-related protocol data, not just device names and addresses. Review and sanitize them before uploading.

Getting help

Search existing issues first. When opening a new issue, include the integration version, Home Assistant version, Deco model, hardware version, firmware version, diagnostics, and the relevant sanitized log section.

Clone this wiki locally