Repository navigation
Releases
v3.16.0 - Optional automatic enabling of new client trackers
New feature
- Added Enable trackers for new clients, an opt-in setting for each Deco configuration (#12).
- When enabled, newly registered client trackers are enabled by default. Existing trackers are left unchanged, and Home Assistant's Disable new entities setting still takes precedence.
- The option is off by default, so existing installations keep their current behavior.
Thanks to @CarlosMChica for proposing this in amosyuen/ha-tplink-deco#680.
v3.15.5 - Marketplace Catalog Preparation
This release completes the validation required for catalog submission. It does not change integration behavior, configuration, or entity IDs.
v3.15.4 - First independent ha-deco release
First independent ha-deco release
This release continues the TP-Link Deco integration under independent maintenance by Dennis (@dkwolf1). The integration domain remains tplink_deco.
- Preserves the start of syslog bursts with chronological, checkpointed batches.
- Preserves naming settings and the syslog destination during reauthentication.
- Points installation, documentation, and support links to this repository.
Add this repository as a custom repository in Marketplace or HACS. See the installation guide.
Thanks to Amos Yuen for the original integration, @oncleben31 and @ludeeus for the templates, @alunduil for validating the syslog fix, and @rjullien for the reauthentication fix.
v3.15.3-beta.2 - Reauthentication Settings and Syslog Burst Fixes
Changes
- Preserve client and Deco name prefixes/postfixes and the syslog destination when reauthenticating (#677).
- Retain the syslog burst improvements introduced in beta.1: send new lines oldest-first in batches, checkpoint completed batches and resume remaining lines on subsequent polls when they are still available (#675).
Testing
Please use beta.2 for further testing instead of beta.1.
The live WAN-disconnection validation tracked in #674 is still pending. Syslog forwarding remains best-effort: UDP delivery is not guaranteed, and unsent lines can be lost if the Deco rotates its log.
Thanks
- @rjullien for identifying and fixing the reauthentication settings reset, including regression coverage (#677).
- @alunduil for reporting the syslog burst loss and providing testing details (#674).
Full changelog: amosyuen/ha-tplink-deco@v3.15.2...v3.15.3-beta.2
v3.15.3-beta.1 - Syslog Burst Validation
Syslog Burst Validation Beta
- Forward fetched new lines chronologically in checkpointed batches instead of discarding older lines at the previous 1,000-line poll cap.
- Resume from completed batches after errors, cancellation, timeouts or polling pauses.
- Retain UDP pacing and network timeouts, with a 30-second formatting/sending/checkpointing budget.
- Automated burst/recovery coverage is included. Live WAN-outage validation is still pending.
UDP remains best effort. Partial sends can duplicate lines, and router log rotation can remove unsent data. This is not a guaranteed lossless archive.
Thanks to @alunduil (Alex Brandt) for the detailed reproduction and offer to test #674. v3.15.2 remains the latest stable release.
v3.15.2 - Compressed Deco System Log Support
Fixes
- Decode plain-text, gzip, tar and gzip-compressed tar system-log snapshots, addressing the firmware formats reported on BE65 and BE9300.
- Fix both manual system-log downloads and syslog forwarding through their shared API path.
- Process decompression/archive decoding outside the HA event loop; handle empty/corrupt archives and ignore links without extracting files to disk.
- Add regression coverage. Existing settings and plain-text log support are retained.
Thanks
Thanks to @cstosgale (Chris Stos-Gale) for the original implementation and BE9300 testing in #671, and @ryanpalfrey for reporting the BE65 failure in #672. The extended implementation has automated coverage; confirmation on the affected hardware is welcome.
v3.15.1 - Fix Setup Form Compatibility
Fixes
- Fix setup and options forms failing to load because the Deco interval validator could not be serialized, as reported on Home Assistant 2026.3.3.
- Preserve interval 0 and all intervals of at least 10 seconds; show a clear error for values 1-9.
- Existing valid configurations and polling behavior remain unchanged.
- Add form serialization/validation regression coverage and a dedicated HA 2026.3.3 CI job.
Thanks
Thanks to @arozwalak (Artur Rozwalak) for the detailed report and reproduction information in #668.
v3.15.0 - System Logs, Syslog Forwarding and Session Cleanup
New Features
- Download the Deco system log using the
tplink_deco.download_system_logaction. The action saves a file under<config>/tplink_deco_logs/and returns its path and line count. Config-entry selection is supported when multiple entries are loaded. (#650) - Optionally forward new Deco system log lines to a syslog receiver over UDP or TCP. Forwarding is disabled by default and configured per entry. Based on #660 and the original work in #607.
- Syslog forwarding remembers its position across Home Assistant restarts, skips existing history on first enable, respects polling pause, and stops before logout on integration unload.
Fixes and Improvements
- Give each polling switch a config-entry-specific unique ID and migrate the old ID while preserving the existing entity ID. (#655, replacing #648; fixes #647)
- Release the Deco session after successful config-entry unload, with coordinator cleanup performed in the correct order. Failed platform unloads retain runtime state. (#656, replacing #652)
- Handle Deco nodes with missing or empty nicknames by falling back to their MAC address. (#651)
- Remove the deprecated
CONN_CLASS_CLOUD_POLLdeclaration;iot_classremainslocal_polling. (#658; fixes #664) - Update Slovak setup/options translations, including the remaining untranslated interval label. Based on #653.
- Link the README to the documentation wiki. (#659)
- Update development/test constraints for pip and Ruff. (#662, #663)
Validation
- Locally checked Python syntax, JSON, pre-commit and diff whitespace.
- Live tested UDP and TCP forwarding, including reception of 1,000-line batches.
- Verified TCP forwarding resumes after a Home Assistant restart and stops when disabled.
- Manual system-log download and the polling switch were tested by the maintainer.
- Normal Deco, client and wireless updates continued successfully during the observed test.
- The combined release PR passed the required GitHub checks before merge.
Live validation covers the maintainer's setup, not every Deco model, firmware or multi-entry arrangement. Additional scenarios have automated regression coverage.
Important Notes
- Each syslog poll downloads the whole Deco log and uses the shared API session, which can delay other requests. The default forwarding interval is 300 seconds.
- Only the newest 1,000 new lines are forwarded per poll. If more lines are generated, older excess lines are skipped; this is not a lossless log archive.
- Syslog transport is unencrypted. Raw Deco logs may contain client identifiers and authentication-related protocol data. Use a trusted local receiver and review/redact logs before sharing them publicly.
- UDP delivery is best effort. TCP retries after a partial send can duplicate messages.
- Log downloads and forwarding are unsupported on legacy encrypted local-web firmware such as the affected Deco S7 firmware. Forwarding emits one warning and stops until reload.
Thanks
- @alunduil (Alex Brandt): manual system-log download and opt-in syslog forwarding.
- @gappleby: original system-log implementation, parsing and tail-matching work in #607.
- @rjullien (Rene Jullien): nickname fallback and the original session-cleanup implementation and tests.
- @SJRepos: the original multi-entry polling-switch fix.
- @misa1515: Slovak translation updates and the deprecation report.
- @dkwolf1: integration, lifecycle/migration safeguards, regression coverage and live release testing.
- @dependabot: development dependency updates.
AI-assisted contributions retain the original co-author attribution in the integration commit.
v3.15.0-beta.2 - Multi-Entry and Session Cleanup
Changes
- Migrates polling switch unique IDs so every TP-Link Deco config entry has its own polling control.
- Migrates existing polling switch entities without unnecessarily changing their entity IDs.
- Correctly shuts down the Deco, client, mobile and wireless coordinators during unload.
- Logs out standard and legacy encrypted Deco sessions after a successful unload.
- Preserves the active integration runtime when platform unload fails.
- Includes the manual Deco system-log download action introduced in beta.1.
- Includes safer handling for Deco nodes without a configured nickname.
Testing requested
Please verify:
- existing polling switch entity IDs remain unchanged after upgrading;
- multiple Deco config entries have separate polling switches;
- reloading and unloading the integration produces no coordinator or logout errors;
- the integration reconnects normally after a reload;
- manual system-log downloads still work.
Please report any regression with the Home Assistant log and a diagnostics download. Remove passwords, tokens and other private information before uploading logs.
Contributors
Special thanks to @SJRepos, @rjullien, @alunduil and @gappleby for their implementations, testing and regression coverage.
Includes #650, #651, #655 and #656.
Fixes #647.
v3.15.0-beta.1 - Manual System Log Download
Changes
- Added the
tplink_deco.download_system_logHome Assistant action. - Uses the Deco web interface's fast
save_logendpoint. - Supports explicit config-entry selection for installations with multiple Deco networks.
- Added selectable log severity levels and safe output filename validation.
- Saves downloaded logs in the
tplink_deco_logsdirectory. - Added a stable MAC-address fallback when firmware omits Deco nickname fields.
Compatibility
The system-log action uses the standard LuCI web session.
Firmware using the legacy encrypted web session, including affected Deco S7 firmware, is not currently supported by this action. Existing polling, entities and configuration remain unchanged.
Testing
This is a beta release intended to validate the system-log endpoint across additional Deco models and firmware versions.
All automated tests, Home Assistant 2026.11 compatibility checks, HACS validation, Hassfest validation and pre-commit checks passed.
Includes #650 and #651.
Continues the manual-download portion of #607.