Skip to content

Releases: home-assistant/operating-system

Home Assistant OS 17.1

12 Feb 14:09
17.1
8a14ad2

Choose a tag to compare

Changes

This release fixes issues discovered in 17.0. Bug in Containerd causing excessive logging has been fixed. Compatibility issue with the latest OpenCCU add-on has been resolved by updating the generic_raw_uart driver for glibc 2.42+. Linux kernel of all targets has been updated to the latest stable version. All users are encouraged to upgrade.

Note that Home Assistant OS 17.1 uses Docker Containerd snapshotter by default, optional migration steps for existing installations are available in the 17.0 release notes.

Home Assistant Operating System

  • Add RAUC patch to annotate all messages with SYSLOG_IDENTIFIER (#4510) @sairon
  • Backport GLib patch adding SYSLOG_IDENTIFIER to logging messages (#4506) @sairon
  • Add generic_raw_uart patch for termios2/glibc 2.42+ compatibility (#4504) @jens-maus
  • Bump Containerd to v2.2.1 to fix possible log spam (#4502) @sairon
  • Bump Buildroot to 2025.02.10 (#4499) @sairon

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

Khadas VIM Series

Generic aarch64

Dependencies

Home Assistant OS 17.1.rc1

30 Jan 13:05
17.1.rc1
79e0504

Choose a tag to compare

Pre-release

Changes

This release fixes issues discovered in 17.0. Bug in Containerd causing excessive logging has been fixed. Compatibility issue with the latest OpenCCU add-on has been resolved by updating the generic_raw_uart driver for glibc 2.42+. Linux kernel of all targets has been updated to the latest stable version. All users are encouraged to upgrade.

Note that Home Assistant OS 17.1 uses Docker Containerd snapshotter by default, optional migration steps for existing installations are available in the 17.0 release notes.

Home Assistant Operating System

  • Add RAUC patch to annotate all messages with SYSLOG_IDENTIFIER (#4510) @sairon
  • Backport GLib patch adding SYSLOG_IDENTIFIER to logging messages (#4506) @sairon
  • Add generic_raw_uart patch for termios2/glibc 2.42+ compatibility (#4504) @jens-maus
  • Bump Containerd to v2.2.1 to fix possible log spam (#4502) @sairon
  • Bump Buildroot to 2025.02.10 (#4499) @sairon

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

Khadas VIM Series

Generic aarch64

Dependencies

Home Assistant OS 17.0

19 Jan 11:11
17.0
8e1d61b

Choose a tag to compare

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

Home Assistant OS 17.0.rc2

08 Jan 12:23
17.0.rc2
1608fa3

Choose a tag to compare

Pre-release

Changes

This release contains the following list of various bug fixes and updates since the previous beta release. See 17.0.rc1 release notes for the list of changes since the latest stable release.

Home Assistant Operating System

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

Khadas VIM Series

Generic aarch64

Dependencies

Home Assistant OS 17.0.rc1

09 Dec 12:49
17.0.rc1
cf72489

Choose a tag to compare

Pre-release

Changes

Home Assistant OS 17.0.rc1 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.2 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 resource efficiency. 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
  • At least 50% free storage space is recommended before starting the migration
  • The migration will be applied on the next system reboot

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

Home Assistant OS 16.3

04 Nov 12:28
16.3
bd5ea37

Choose a tag to compare

Changes

This release brings updates and fixes for all platforms. Linux kernel of all targets including Raspberry Pi-based boards has been updated to the latest stable version. Bug in Docker causing slow or compeletely stalled system startup has been identified and fixed. Compatibility issues of the generic x86-64 build with latest Intel Ultra platforms have been resolved and several system components updated. The default console now shows more helpful messages when Home Assistant services don't start in time. All users are recommended to update.

Home Assistant Operating System

Raspberry Pi

  • Disable UAS via usb-storage.quirks on RPi for JMicron JMS583Gen 2 to PCIe Gen3x2 Bridge (#4366) @vichle
  • RaspberryPi: Update kernel to 6.12.47 - stable_20250916 (#4327) @sairon

Home Assistant Yellow

  • Disable UAS via usb-storage.quirks on RPi for JMicron JMS583Gen 2 to PCIe Gen3x2 Bridge (#4366) @vichle
  • RaspberryPi: Update kernel to 6.12.47 - stable_20250916 (#4327) @sairon

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

ASUS Tinker

Khadas VIM Series

Generic aarch64

Build System

  • Remove usage of --content-trust CLI option in Supervisor tests (#4371) @sairon
  • Use matching version of DinD daemon when creating hassio data partition (#4344) @sairon
  • Use original hadolint action instead of outdated fork (#4332) @sairon
  • Fix build failure caused by RaspberryMatic project renaming (#4324) @sairon
  • Pin SHA for all Github Actions (#4305) @silamon
  • Implement better support for --silent flag in top-level Makefile (#4292) @sairon

Dependencies

Home Assistant OS 16.3.rc1

14 Oct 16:21
16.3.rc1
92c1bc1

Choose a tag to compare

Pre-release

Changes

This release brings updates and fixes for all platforms. Linux kernel of all targets including Raspberry Pi-based boards has been updated to the latest stable version. Compatibility issues of the generic x86-64 build with latest Intel Ultra platforms have been fixed and several system components updated. The default console now shows more helpful messages when Home Assistant services don't start in time. All users are recommended to update.

Home Assistant Operating System

Raspberry Pi

  • RaspberryPi: Update kernel to 6.12.47 - stable_20250916 (#4327) @sairon

Home Assistant Yellow

  • RaspberryPi: Update kernel to 6.12.47 - stable_20250916 (#4327) @sairon

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

ASUS Tinker

Khadas VIM Series

Generic aarch64

Build System

  • Use matching version of DinD daemon when creating hassio data partition (#4344) @sairon
  • Use original hadolint action instead of outdated fork (#4332) @sairon
  • Fix build failure caused by RaspberryMatic project renaming (#4324) @sairon
  • Pin SHA for all Github Actions (#4305) @silamon
  • Implement better support for --silent flag in top-level Makefile (#4292) @sairon

Dependencies

Home Assistant OS 16.2

08 Sep 14:03
16.2
d60618a

Choose a tag to compare

Changes

This release brings updates and fixes for all platforms, updating Linux kernel to the latest stable version and various system components. Bug causing problems with some USB-Serial convertes on Home Assistant Yellow and Raspberry Pi has been fixed. Several improvements have been done to improve experience when pairing BLE devices. Timezone configured in Home Assistant settings is now propagated to the operating system and used for instance when reading logs directly on the host. All users are recommended to update.

Home Assistant Operating System

Raspberry Pi

  • Fix missing rpi-rf-mod overlay on Yellow (#4244) @sairon
  • Backport patches for Raspberry Pi dwc2 driver (#4231) @sairon

Home Assistant Yellow

  • Fix missing rpi-rf-mod overlay on Yellow (#4244) @sairon
  • Backport patches for Raspberry Pi dwc2 driver (#4231) @sairon

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

ASUS Tinker

Khadas VIM Series

Generic aarch64

Build System

  • Generate list of built-in containers in GH build summary (#4247) @sairon
  • Add checkbox for running test in GH build workflow (#4246) @sairon
  • Fix scripts/enter.sh so it is usable on macOS (#4243) @slonopotamus
  • Enable publishing of dev builds to R2 without bumping version (#4232) @sairon

Home Assistant OS 16.2.rc2

01 Sep 16:21
16.2.rc2
a258295

Choose a tag to compare

Pre-release

Changes

This release fixes intermittent problems with network connectivity caused by an upstream kernel regression introduced in 16.2.rc1 (issue #4265). Raspberry Pi boards and Home Assistant Yellow were not affected by this bug.

In case you have already updated to 16.2.rc1 and have problems downloading the update, revert to the previous OS version from CLI first using ha os boot-slot other.

Home Assistant Operating System

  • Fix broken outgoing connections caused by upstream kernel regression (#4267) @sairon

Home Assistant OS 16.2.rc1

28 Aug 14:27
16.2.rc1
94fe13f

Choose a tag to compare

Pre-release

Changes

This release brings updates and fixes for all platforms, updating Linux kernel to the latest stable version and various system components. Bug causing problems with some USB-Serial convertes on Home Assistant Yellow and Raspberry Pi has been fixed. Several improvements have been done to improve experience when pairing BLE devices. Timezone configured in Home Assistant settings is now propagated to the operating system and used for instance when reading logs directly on the host. All users are recommended to update.

Home Assistant Operating System

Raspberry Pi

  • Fix missing rpi-rf-mod overlay on Yellow (#4244) @sairon
  • Backport patches for Raspberry Pi dwc2 driver (#4231) @sairon

Home Assistant Yellow

  • Fix missing rpi-rf-mod overlay on Yellow (#4244) @sairon
  • Backport patches for Raspberry Pi dwc2 driver (#4231) @sairon

Home Assistant Green

Open Virtual Appliance

Generic x86-64

Hardkernel ODROID

ASUS Tinker

Khadas VIM Series

Generic aarch64

Build System

  • Generate list of built-in containers in GH build summary (#4247) @sairon
  • Add checkbox for running test in GH build workflow (#4246) @sairon
  • Fix scripts/enter.sh so it is usable on macOS (#4243) @slonopotamus
  • Enable publishing of dev builds to R2 without bumping version (#4232) @sairon