Skip to content

Home Assistant OS 17.0

Choose a tag to compare

View all tags
@sairon sairon released this 19 Jan 11:11
· 68 commits to dev since this release
17.0
This tag was signed with the committer’s verified signature.
sairon Jan ČermÑk
GPG key ID: A78C897AA3AF012B
Verified
Learn about vigilant mode.
8e1d61b
This commit was signed with the committer’s verified signature.
sairon Jan ČermÑk
GPG key ID: A78C897AA3AF012B
Verified
Learn about vigilant mode.

Changes

Home Assistant OS 17.0 is a major release bringing significant updates to all platforms. This release also drops support for 32-bit armv7 targets (Raspberry Pi 2/3/4 32-bit, ODROID-XU4, and ASUS Tinker Board) as announced in May 2025. The Linux kernel has been updated to the latest version across all targets, and Docker has been upgraded to v29.1.3 with containerd v2.2.0. New installations now use the Docker containerd snapshotter by default. Console keyboard layouts can now be configured through localectl, making it easier to use non-US keyboard layouts when accessing the system console directly. All users on supported platforms are recommended to update.

⚠️ Breaking Changes

This release removes support for the following 32-bit armv7 targets:

  • Raspberry Pi 2 (rpi2)
  • Raspberry Pi 3 32-bit (rpi3)
  • Raspberry Pi 4 32-bit (rpi4)
  • ODROID-XU4 (odroid-xu4)
  • ASUS Tinker Board (tinker)

Users of these devices will no longer receive updates. If you are using one of these boards, your device will no longer receive updates, please consider migrating to a supported 64-bit platform.

Docker Containerd Snapshotter

Starting with this release, new installations use the Docker containerd snapshotter by default, which provides improved performance and stability. Existing users can migrate to the new storage driver using the following command:

ha docker migrate-storage-driver

Before migrating, please note:

  • Create a full Home Assistant backup before proceeding
  • Internet connectivity is required for re-downloading all container images, this make take some time, especially with many installed add-ons or with slow internet connection
  • At least 50% free storage space is recommended before starting the migration (note that the new snapshotter has slightly higher storage requirements)
  • The migration will be applied on the next system reboot
  • After the migration completes, another Supervisor or system restart may be needed to clear any add-on warnings

Note: This migration is optional and not required for your system to function properly after the update. It is recommended to perform an attended migration yet not immediately after updating, but once you have verified the system works correctly before the migration. Additionally, ensure you have reliable access (such as physical device access or access to a VM console) in case recovery is needed.

Home Assistant Operating System

Raspberry Pi

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

Khadas VIM Series

Generic aarch64

Build System

  • Remove deprecated boards from build matrix and .github templates (#4399) @sairon
  • Clean up hassio build scripts (#4394) @sairon
  • Use OCI archive in hassio import to fix Containerd snapshotter issues (#4393) @sairon
  • Fix tests to accommodate wait for container re-download on downgrade (#4368) @sairon

Dependencies

Contributors

sairon, jmarshallnz, and 3 other contributors
Assets 37
Loading
97 Join discussion