Skip to content
dkwolf1 edited this page Nov 11, 2026 · 2 revisions

Frequently Asked Questions

Which credentials should I use?

Use username admin and the Deco owner account password. A manager account does not work with the local web API.

Can I keep using the Deco app?

Yes, but use a separate manager account for daily app access. Logging in as the owner can invalidate Home Assistant's local session.

Should I use HTTP or HTTPS?

Use the exact address that opens the main Deco web interface. Include the scheme. When HTTPS uses a self-signed certificate, disable certificate verification in the integration form.

Is disabling SSL verification safe?

Traffic remains encrypted, but Home Assistant no longer verifies that the certificate was issued by a trusted authority. This is commonly necessary for self-signed certificates on local routers. Only connect to the expected local Deco address on a trusted network.

Can the integration enable or disable WiFi networks?

No. WiFi status is read-only because local write endpoints are not reliable across models and firmware versions.

Why do I see devices from another integration?

Home Assistant can combine devices that share the same MAC address. Disable Link client trackers to devices by MAC address if you want Deco client trackers kept separate.

Why are some entities disabled?

Home Assistant disables some diagnostic or optional entities by default. Open the device's entity list and enable the entity manually. Main WiFi status is intentionally disabled by default.

Why is mobile data usage missing?

It is created only when supported cellular Deco firmware exposes the required endpoint.

What does client query mode mean?

The integration normally queries clients per Deco node. It can use a bounded global fallback when all per-node requests fail and periodically probes per-node mode again.

Can I reduce load on the mesh?

Increase the polling interval. If device_list affects wireless backhaul, increase the separate Deco status interval or set it to 0, then use Refresh Deco status only when needed.

Does pausing polling disable the integration?

No. It stops scheduled updates while keeping entities and the session loaded. Resume polling with the switch or tplink_deco.resume_polling.

Where is the downloaded Deco log saved?

Under <config>/tplink_deco_logs. The router log is not automatically redacted.

Can I send logs to a syslog server?

Yes, since v3.15.0. Enable forwarding in the entry's integration options and configure the receiver host, port and UDP/TCP protocol. It is off by default. See Syslog.

Is syslog a complete log archive?

No. Each poll forwards at most the newest 1,000 new lines and skips older excess lines. UDP delivery is best effort; TCP retries can duplicate partially delivered data. Use manual download when you need the full log currently retained by the router.

Is syslog encrypted or automatically anonymized?

No. Use a trusted local receiver and inspect output before sharing. Raw logs can contain authentication-related protocol data, not just network identifiers.

Why does nothing arrive immediately after enabling forwarding?

The first successful download records the current position without sending old history. Wait for a subsequent poll and confirm new router log events exist. Check the exact receiver port and protocol as well as firewall/VPN restrictions.

Why do beta.2 users still see the deprecated connection-class warning?

The fix was merged after beta.2. Install stable v3.15.0 or newer and restart Home Assistant. Historical warnings may remain visible; compare their timestamps.

Why does the Deco app show the same wrong client list as Home Assistant?

That strongly suggests a firmware-side client database or API problem. Reboot the mesh, check for firmware updates, and contact TP-Link when both interfaces remain incorrect.

Will updating change my entity IDs?

Normal updates should preserve unique IDs. Always back up Home Assistant before major updates. Report duplicate or renamed entities with entity-registry details and diagnostics.

How do I report a problem?

Follow Diagnostics-and-Bug-Reports. Include evidence from the current release rather than logs from an old local copy.

Clone this wiki locally