home-assistant.io

Home Assistant's iOS Companion app will stop receiving updates on devices running iOS 15, watchOS 8, or macOS 11 starting with version 2026.8.0, expected this August — and the engineering reason behind the cut goes deeper than most coverage has acknowledged. Independent smart home publication The Ambient reported the change this week, noting that specialty outlets are tracking the story as active news. The decision was not primarily a business calculation about a small user group, though that math is straightforward enough: the Home Assistant team confirmed in its July 7 announcement that fewer than one percent of its more than two million active users currently run any of the affected platforms. The structural reason is that Apple's upcoming Xcode 27 toolchain, already in developer beta since June 8 and expected to reach its general release this fall, raises the minimum watchOS deployment target to version 9 — and for any iOS app that embeds a Watch companion, that change is not an upgrade option but a build failure.

The final version to support iOS 15, watchOS 8, and macOS 11 is version 2026.7.1, which was released on July 3 and will remain on the App Store indefinitely. Users who cannot or choose not to upgrade may freeze their Companion app there, compile their own build from source, or switch to the web-based frontend, which runs in any browser and receives monthly updates regardless of OS version.

The Home Assistant platform itself — the server software, automations, integrations, and dashboard — is entirely unaffected by this announcement. What changes is the native iOS app's future update path.

Why Xcode 27 Made This Mandatory, Not Optional

The proximate cause of the deprecation is a build-system constraint that Apple introduced in Xcode 27. A GitHub issue filed June 15 against the Home Assistant iOS project documented the specific failure: when Xcode 27 beta compiles the Home Assistant iOS project, the Watch app target fails with the error "The watchOS deployment target 'WATCHOS_DEPLOYMENT_TARGET' is set to 8.0, but the range of supported deployment target versions is 9.0 to 27.0.x." The issue was assigned to Bruno Pantaleão, the same developer who authored the July 7 blog post announcing the change.

The critical detail, also documented in that issue, is that the Watch app is embedded inside the iOS app bundle — not a separate submission. When the Watch app cannot compile, the entire iOS app build fails, not just the Watch-specific portion. For a team submitting updates through the App Store, this is a hard stop: once Xcode 27 becomes the required toolchain for new App Store submissions, the team cannot ship any iOS update at all without first raising the deployment target. The same constraint is being applied across the Apple developer ecosystem — the Sentry iOS SDK filed an identical issue and set their own watchOS 9 migration deadline for August 2026, citing the need to stay ahead of Xcode 27's general availability.

The Home Assistant team's decision to announce the change in July, well before Xcode 27's fall release, reflects that window. Users on affected devices have time now to evaluate their options before August, when 2026.8.0 is expected to ship. Waiting until Xcode 27's general release to communicate the change would have left affected users with no runway.

What the Drop Unlocks: ClockKit Is the Architectural Bottleneck

The features the Home Assistant team cited as newly buildable — richer Apple Watch complications and advanced widget support — were not optional add-ons the team had been slow to implement. They were architecturally blocked by the dual-framework requirement that watchOS 8 imposes.

watchOS 9, released in 2022, is where Apple deprecated ClockKit at WWDC 2022 — the original framework for building complications — in favor of WidgetKit. Under ClockKit, Apple Watch complications came in 12 distinct families. WidgetKit replaced that system with four standardized families: accessoryCircular, accessoryCorner, accessoryRectangular, and accessoryInline. These families integrate natively with SwiftUI and with the Smart Stack — the upward-swipe widget layer available since watchOS 10. The WidgetKit timeline model also allows complications to surface structured, data-rich content in ways the ClockKit template system did not support.

An app that targets watchOS 8, however, must continue shipping ClockKit code alongside any WidgetKit implementation, because watchOS 8 devices cannot use WidgetKit complications. That means two parallel code paths for every complication feature — doubled testing surface, doubled maintenance, and a ceiling on what either path can do because the ClockKit side cannot access WidgetKit-only APIs. The specific complaint from Home Assistant's Watch user community — that complications were limited and not improving at the pace of other features — traces directly to this constraint. The team could not invest fully in WidgetKit complications while they were obligated to maintain a ClockKit implementation for less than one percent of their users.

Dropping watchOS 8 eliminates the ClockKit dependency entirely. The team can now implement complications exclusively in WidgetKit, with access to Smart Stack integration, richer data displays, and the SwiftUI layout system. The same logic applies to widget support more broadly on iOS: iOS 16.4 (the new minimum) supports interactive widgets and lock screen customization that iOS 15 does not.

Who Is Actually Affected

The users most likely to notice this change are those running Home Assistant on a repurposed older iPhone or iPad mounted as a wall-panel dashboard — a common smart home setup in which a device too outdated for daily use gets a second life as a dedicated home control interface. Devices deployed this way are often deliberately frozen at iOS 15 for stability, and they may be running it not because they lack upgrade eligibility but because a working wall panel is not something you update casually.

For those users, the web frontend remains a functional alternative. It runs in Safari on iOS 15 and receives the same monthly core updates as the platform itself. The native features that will no longer update are the ones tied to iOS integration: device location sensors feeding into automations, actionable push notifications, lock screen and home screen widgets, and the Apple Watch companion.

Users running an Apple Watch on watchOS 8 independently face a similar calculation. watchOS 8 is the last version that ran on the Apple Watch Series 3, which Apple itself discontinued in 2022. The Apple Watch Series 4 through 8, SE 2, and original Ultra can all run watchOS 9 or later, and for those users an upgrade to watchOS 9 would restore full compatibility with future Companion app releases. The question for those users is whether to update their watch OS while keeping the phone on iOS 15 — a configuration that is supported by Apple but not tested by Home Assistant.

For context, Apple's own deprecation announcement this fall will be considerably more sweeping: watchOS 27, unveiled at WWDC 2026, will drop the Apple Watch Series 6, 7, 8, SE 2, and original Ultra — devices released as recently as 2022. Apple Watch marketing manager Cait Dooley told TechRadar that performance requirements for the new Siri AI features drove the cutoff. Home Assistant's change, by comparison, affects hardware from 2021 and earlier running software Apple stopped updating years ago.

What Stays Available and What Happens Next

Version 2026.7.1 will remain available on the App Store — Home Assistant confirmed it will not be removed — and its source code will stay publicly accessible on GitHub. Users who want to run a current build of the app on iOS 15 without updating will be able to compile from that source, though they will need access to an Apple developer account and Xcode to do so, and they will not receive future feature updates or security patches through this path.

The Home Assistant core platform — the server that actually runs automations, talks to smart home devices, and stores data locally — will continue receiving monthly updates on its normal schedule. Version 2026.8.0 of the core platform, also expected in August, is a separate release from the Companion app and is not affected by this change. Users who depend on Home Assistant primarily via a web browser or the Android Companion app will see no change at all.

The Companion app for iOS 16.4 and later will receive the features that the watchOS 8 constraint had blocked: WidgetKit-based Apple Watch complications with richer data displays and Smart Stack integration. These have been among the most consistently requested features on the Apple platforms, and the team has now committed to building them once the ClockKit dependency is eliminated.

Frequently Asked Questions

Will my older iPhone stop working as a Home Assistant dashboard after August?

No device will lose access to Home Assistant entirely. The change means the Companion app on iOS 15, watchOS 8, or macOS 11 will stop receiving updates after version 2026.7.1 — it will not be deleted, and it will continue working as it does today. The Home Assistant web frontend in Safari remains fully functional on iOS 15 and receives monthly updates. The features that will not improve on frozen devices are those dependent on the native iOS Companion app: location sensors, push notifications, and widgets.

What exactly does Xcode 27 have to do with this?

Apple's developer toolchain, Xcode 27, sets a hard minimum deployment target of watchOS 9 for any Watch app submitted to the App Store. Because the Home Assistant iOS app includes an embedded Watch app, attempting to build the project with Xcode 27 produces a build error that prevents the entire iOS app — not just the Watch portion — from compiling. Once Xcode 27 becomes the required toolchain for App Store submissions (expected this fall), the team would be unable to ship any iOS update without first raising the deployment target. The deprecation resolves this in advance, before the toolchain change forces the issue.

Can I still use an Apple Watch with Home Assistant on iOS 15?

Only with the frozen Companion app version 2026.7.1. If you run watchOS 9 or later on an Apple Watch paired to an iPhone running iOS 15, future Companion app updates will not install on the iPhone and the Watch app will not receive new features. Home Assistant will continue working as it did on the day of version 2026.7.1. Users who want access to the new WidgetKit complications the team is now developing will need to upgrade both the iPhone (to iOS 16.4) and the Apple Watch (watchOS 9 or later).

Which Apple Watch models are compatible with watchOS 9?

Apple Watch Series 4 and later, Apple Watch SE (first generation) and later, and Apple Watch Ultra (all generations) can all run watchOS 9 or later. The Apple Watch Series 3 is limited to watchOS 8 and is not eligible to upgrade. For Series 3 users, the 2026.7.1 Companion app will remain the last compatible version, as confirmed by Apple's Watch compatibility chart.