Skip to content

Configuration

dkwolf1 edited this page Nov 22, 2026 · 3 revisions

Configuration

Configuration and reconfiguration are performed from Settings > Devices & services > TP-Link Deco.

Connection settings

Host

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 and password

  • 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.

Verify SSL certificate is valid

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.

Polling settings

Polling interval

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.

Deco status polling interval

Controls device_list separately from client and performance polling.

  • Minimum automatic interval: 10 seconds
  • 0: query device_list only 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.

Consider home

How long a missing client remains home before its tracker changes to not home. Increase this when clients briefly disappear between polls.

Timeout seconds

Maximum time to wait for a router request. Increasing this can help slow firmware, but the Deco may enforce its own timeout first.

Timeout error retry count

Number of retries after a request timeout. Higher values can improve tolerance but also extend a slow polling cycle and increase router load.

Device and entity settings

Link client trackers to devices by MAC address

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.

Enable trackers for new clients

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.

Show WiFi network names

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.

Name prefixes and postfixes

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.

Disable new entities by default

Open the integration menu, select System options, and disable Enable newly added entities. This is useful on networks with many transient clients.

Runtime controls

  • 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_polling and tplink_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.

Syslog forwarding

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.