-
-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Add dev blog post about legacy device tracker deprecation #3060
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Draft
emontnemery
wants to merge
2
commits into
master
Choose a base branch
from
blog_legacy_device_tracker_deprecation
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+107
−0
Draft
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,107 @@ | ||
| --- | ||
| author: Erik Montnemery | ||
| authorURL: https://github.com/emontnemery | ||
| title: "Deprecation of legacy device tracker platform API" | ||
| --- | ||
|
|
||
| ## Summary | ||
|
|
||
| The legacy (non config entry) device tracker platform API is deprecated and will be removed in the Home Assistant 2027.5 release. | ||
| By the end of the 12-month deprecation period, all legacy device tracker platforms will be removed from the core repo, and custom integrations implementing the legacy API will stop working. | ||
|
|
||
| ## Background | ||
|
|
||
| Config entry device trackers were introduced in May 2019, which means integration authors have had 8 years to migrate integrations when support is removed in May 2027. | ||
|
|
||
| As of today (April 2026) most widely used core device tracker integrations have already been migrated. | ||
|
|
||
| Note that the most popular integration that has not yet been migrated, xiaomi_miio, has a wide mix of functionality including other things than device tracker. | ||
|
|
||
| The proposal to deprecate the legacy device tracker API was approved in [architecture proposal 1375](https://github.com/home-assistant/architecture/discussions/1375). | ||
|
|
||
| ### List of core integrations, sorted by reported use | ||
|
|
||
| The list was generated from https://analytics.home-assistant.io/ in March 2026 | ||
|
|
||
| ```text | ||
| Integration Installations API Type Details | ||
| ---------------------------------------------------------------------------------------------------- | ||
| mobile_app 415,204 modern tracker TrackerEntity | ||
| mqtt 233,161 modern tracker TrackerEntity | ||
| zha 126,903 modern scanner ScannerEntity | ||
| ibeacon 89,099 modern unknown BaseTrackerEntity | ||
| fritz 42,934 modern scanner ScannerEntity | ||
| ping 33,439 modern scanner ScannerEntity | ||
| unifi 33,136 modern scanner ScannerEntity | ||
| xiaomi_miio 12,866 legacy scanner async_scan_devices | ||
| nmap_tracker 7,397 modern scanner ScannerEntity | ||
| icloud 5,772 modern tracker TrackerEntity | ||
| freebox 5,312 modern scanner ScannerEntity | ||
| asuswrt 4,686 modern scanner ScannerEntity | ||
| tile 4,212 modern tracker TrackerEntity | ||
| renault 3,646 modern tracker TrackerEntity | ||
| private_ble_device 3,231 modern unknown BaseTrackerEntity | ||
| keenetic_ndms2 3,080 modern scanner ScannerEntity | ||
| owntracks 3,022 modern tracker TrackerEntity | ||
| snmp 2,923 legacy scanner async_scan_devices | ||
| devolo_home_network 2,910 modern scanner ScannerEntity | ||
| tesla_fleet 2,798 modern tracker TrackerEntity | ||
| netgear 2,782 modern scanner ScannerEntity | ||
| mikrotik 2,761 modern scanner ScannerEntity | ||
| tplink_omada 2,708 modern scanner ScannerEntity | ||
| starlink 2,250 modern tracker TrackerEntity | ||
| tractive 2,144 modern tracker TrackerEntity | ||
| volvo 2,077 modern tracker TrackerEntity | ||
| husqvarna_automower 1,924 modern tracker TrackerEntity | ||
| tessie 1,562 modern tracker TrackerEntity | ||
| bluetooth_le_tracker 1,011 legacy | ||
| traccar_server 978 modern tracker TrackerEntity | ||
| huawei_lte 827 modern scanner ScannerEntity | ||
| gpslogger 813 modern tracker TrackerEntity | ||
| teslemetry 720 modern tracker TrackerEntity | ||
| traccar 609 modern tracker TrackerEntity | ||
| luci 590 legacy scanner scan_devices | ||
| subaru 502 modern tracker TrackerEntity | ||
| mysensors 474 modern tracker TrackerEntity | ||
| starline 460 modern tracker TrackerEntity | ||
| geofency 443 modern tracker TrackerEntity | ||
| google_maps 389 legacy | ||
| locative 378 modern tracker TrackerEntity | ||
| opnsense 355 legacy scanner scan_devices | ||
| fing 266 modern scanner ScannerEntity | ||
| ruckus_unleashed 232 modern scanner ScannerEntity | ||
| synology_srm 193 legacy scanner scan_devices | ||
| unifi_direct 190 legacy scanner scan_devices | ||
| mqtt_json 182 legacy | ||
| vodafone_station 166 modern scanner ScannerEntity | ||
| xiaomi 143 legacy scanner scan_devices | ||
| demo 141 legacy | ||
| ubus 111 legacy scanner scan_devices | ||
| bt_smarthub 95 legacy scanner scan_devices | ||
| aprs 93 legacy | ||
| nrgkick 81 modern tracker TrackerEntity | ||
| ddwrt 79 legacy scanner scan_devices | ||
| fressnapf_tracker 74 modern tracker TrackerEntity | ||
| linksys_smart 69 legacy scanner scan_devices | ||
| fortios 53 legacy scanner scan_devices | ||
| swisscom 51 legacy scanner scan_devices | ||
| tomato 45 legacy scanner scan_devices | ||
| quantum_gateway 42 legacy scanner scan_devices | ||
| aruba 24 legacy scanner scan_devices | ||
| meraki 24 legacy | ||
| sky_hub 22 legacy scanner async_scan_devices | ||
| ituran 19 modern tracker TrackerEntity | ||
| cisco_ios 10 legacy scanner scan_devices | ||
| upc_connect 10 legacy scanner async_scan_devices | ||
| cisco_mobility_express 6 legacy scanner scan_devices | ||
| arris_tg2492lg 2 legacy scanner async_scan_devices | ||
| bbox 1 legacy scanner scan_devices | ||
| actiontec 0 legacy scanner scan_devices | ||
| autoskope 0 modern tracker TrackerEntity | ||
| bt_home_hub_5 0 legacy scanner scan_devices | ||
| cppm_tracker 0 legacy scanner scan_devices | ||
| fleetgo 0 legacy | ||
| hitron_coda 0 legacy scanner scan_devices | ||
| lojack 0 modern tracker TrackerEntity | ||
| thomson 0 legacy scanner scan_devices | ||
| ``` | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.