Repository navigation
Home
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.
- Read Installation before adding the integration.
- Use the Deco owner password with username
admin. Manager credentials do not work. - Enter the complete local web address, including
http://orhttps://. - If the Deco uses a self-signed HTTPS certificate, disable Verify SSL certificate is valid.
- Review Configuration before changing polling or timeout settings.
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.
- Installation - Marketplace, HACS, manual installation, and first setup
- Configuration - every configuration option and recommended defaults
- Entities-and-Actions - trackers, sensors, controls, and actions
- Syslog - receiver setup, UDP/TCP testing, limits, and security
- Troubleshooting - common errors and firmware-specific behavior
- Diagnostics-and-Bug-Reports - diagnostics, debug logs, and useful issue reports
- Supported-Devices-and-Firmware - reported models and firmware notes
- FAQ - short answers to common questions
- Never post passwords, cookies, tokens,
stokvalues, 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_logand 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.
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.