Repository navigation
Configuration
Configuration and reconfiguration are performed from Settings > Devices & services > TP-Link Deco.
Enter the complete local address used to open the main Deco web interface:
http://192.168.68.1
or:
https://192.168.68.1
Do not enter the Deco cloud address, an app-only address, or the IP address of an unrelated gateway. If HTTP redirects to HTTPS, use the final HTTPS address directly.
- Username:
admin - Password: the Deco owner account password
Manager credentials do not work. Leading or trailing characters introduced by copy and paste can also cause invalid_auth.
Leave this enabled only when the Deco presents a certificate trusted by Home Assistant. Disable it when the browser reports a self-signed or untrusted local certificate.
Disabling verification does not change HTTPS encryption. It disables validation of the certificate's trust chain, which is commonly required for local router certificates.
Controls regular performance, client, and optional endpoint updates.
- 10 seconds
- 30 seconds (default)
- 60 seconds
- 120 seconds
Short intervals provide fresher data but increase load on the Deco's embedded web server.
Controls device_list separately from client and performance polling.
- Minimum automatic interval: 10 seconds
-
0: querydevice_listonly during startup or a manual refresh
Use a longer interval or 0 when device_list briefly interrupts wireless backhaul on affected firmware. Client tracking and performance polling continue when automatic Deco status polling is disabled. Press Refresh Deco status after topology changes or adding a node.
How long a missing client remains home before its tracker changes to not home. Increase this when clients briefly disappear between polls.
Maximum time to wait for a router request. Increasing this can help slow firmware, but the Deco may enforce its own timeout first.
Number of retries after a request timeout. Higher values can improve tolerance but also extend a slow polling cycle and increase router load.
Enabled by default. Home Assistant may combine a Deco client tracker with a device from another integration when both expose the same MAC address.
Disable this option to keep client trackers separate. Existing combined devices may need to be removed manually after disabling it.
Default: off. Turn this on for a Deco integration entry to enable newly registered client trackers by default. Existing trackers keep their enabled or disabled state, and trackers for the Deco nodes themselves are unaffected. Home Assistant's Disable new entities setting still takes precedence.
Adds SSID attributes to the read-only WiFi status sensors. Passwords are never read. The attribute may be omitted when firmware does not expose a name.
Optional prefixes and postfixes can be applied independently to clients and Deco nodes. Changing them changes displayed names; avoid repeatedly changing them when stable names are important to dashboards.
Open the integration menu, select System options, and disable Enable newly added entities. This is useful on networks with many transient clients.
- Polling switch: pauses or resumes all integration polling
- Polling interval select: changes the regular interval
-
Refresh Deco status button: immediately refreshes
device_list -
tplink_deco.pause_pollingandtplink_deco.resume_polling: equivalent actions for automations
Each entry has an independent polling switch. Its unique ID is scoped to the entry, and migration preserves the existing switch entity ID. With multiple entries, use the individual switches: the pause/resume actions do not expose an entry selector and should not be treated as reliable per-mesh targeting.
Successful entry unload/reload stops coordinator activity before a best-effort logout. If a platform refuses to unload, runtime state is retained. A full HA restart is not itself proof that a router logout request was sent.
Available since v3.15.0 and disabled by default. Configure each entry independently.
| Option | Default | Meaning |
|---|---|---|
| Forward the Deco system log to a syslog server | Off | Enables background downloads and forwarding |
| Syslog server host | Empty | Receiver IP address or hostname; required when enabled |
| Syslog server port | 514 | Receiver port, from 1 to 65535 |
| Syslog protocol | UDP | UDP datagrams or newline-framed TCP |
| Minimum system log level to forward | ALL | Router-side severity filter |
| Syslog forwarding interval in seconds | 300 | Independent download interval; minimum 60 seconds |
Enter a host without http:// or https://. Match the receiver's protocol and port exactly. Forwarding pauses with the entry's polling switch; a request already running may finish.
System-log downloads share the Deco API session and can delay other polling. Each poll sends at most the newest 1,000 new lines; older excess lines are discarded. Transport is unencrypted and logs are not redacted. See Syslog before enabling.