Releases: home-assistant/operating-system
Home Assistant OS 17.1
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
- Remove dropped R8712U from Rockchip configs (#4511) @sairon
- Linux: Update kernel to 6.12.67 (#4505) @sairon
Open Virtual Appliance
Generic x86-64
Hardkernel ODROID
- Remove dropped R8712U from Rockchip configs (#4511) @sairon
- Linux: Update kernel to 6.12.67 (#4505) @sairon
Khadas VIM Series
Generic aarch64
Dependencies
- Bump actions/setup-python from 6.1.0 to 6.2.0 (#4507) @dependabot[bot]
- Bump actions/checkout from 6.0.1 to 6.0.2 (#4508) @dependabot[bot]
- Bump release-drafter/release-drafter from 6.1.0 to 6.2.0 (#4509) @dependabot[bot]
- Bump actions/cache from 5.0.1 to 5.0.2 (#4489) @dependabot[bot]
Home Assistant OS 17.1.rc1
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
- Remove dropped R8712U from Rockchip configs (#4511) @sairon
- Linux: Update kernel to 6.12.67 (#4505) @sairon
Open Virtual Appliance
Generic x86-64
Hardkernel ODROID
- Remove dropped R8712U from Rockchip configs (#4511) @sairon
- Linux: Update kernel to 6.12.67 (#4505) @sairon
Khadas VIM Series
Generic aarch64
Dependencies
- Bump actions/setup-python from 6.1.0 to 6.2.0 (#4507) @dependabot[bot]
- Bump actions/checkout from 6.0.1 to 6.0.2 (#4508) @dependabot[bot]
- Bump release-drafter/release-drafter from 6.1.0 to 6.2.0 (#4509) @dependabot[bot]
- Bump actions/cache from 5.0.1 to 5.0.2 (#4489) @dependabot[bot]
Home Assistant OS 17.0
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
- Add eq3_char_loop patch for termios2/glibc 2.42+ compatibility (#4471) @jens-maus
- Update generic_raw_uart package to c377d91 (#4472) @jens-maus
- Update Docker to v29.1.3 (#4458) @sairon
- Update BlueZ to v5.85 (#4457) @sairon
- Bump kbd to v2.9.0, remove no longer needed gzip binary (#4456) @sairon
- Bump Buildroot to 2025.02.9 (#4455) @sairon
- Bump OS Agent to v1.8.1 (#4433) @sairon
- Update to Docker v29.1.2, runC v1.3.4, containerd v2.2.0 (#4429) @sairon
- Make console keymaps configurable through
localectl(#4424) @sairon - Bump OS Agent to v1.8.0 (#4420) @sairon
- Bump Buildroot to 2025.02.8 (#4415) @sairon
- Add support for QingHeng CH9200 USB ethernet adapters (#4400) @jmarshallnz
- Remove Docker patch already included in v28.5.2 (#4398) @sairon
- Use correct per-channel AppArmor profile on clean installs (#4396) @sairon
- Update to Docker v28.5.2, runC v1.3.3, containerd v2.1.5 (#4395) @sairon
- Update Go to v1.25 (#4392) @sairon
- Enable iptables comments for all targets (#4391) @monosoul
- Remove support of armv7 targets (#4374) @sairon
- Remove handling of Docker key.json (#4361) @sairon
- Use Docker containerd snapshotter for new and wiped installs (#4360) @sairon
Raspberry Pi
Home Assistant Green
Open Virtual Appliance
Generic x86-64
- Linux: Update kernel to 6.12.63 (#4474) @sairon
- Enable support of i2c-based touchscreens for x86 and aarch64 (#4463) @puterboy
Hardkernel ODROID
Khadas VIM Series
Generic aarch64
- Linux: Update kernel to 6.12.63 (#4474) @sairon
- Enable support of i2c-based touchscreens for x86 and aarch64 (#4463) @puterboy
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
- Bump mikepenz/action-junit-report from 6.0.1 to 6.1.0 (#4473) @dependabot[bot]
- Bump docker/setup-buildx-action from 3.11.1 to 3.12.0 (#4461) @dependabot[bot]
- Bump shogo82148/actions-upload-release-asset from 1.9.1 to 1.9.2 (#4466) @dependabot[bot]
- Bump dessant/label-actions from 4.0.1 to 5.0.0 (#4453) @dependabot[bot]
- Bump actions/upload-artifact from 5.0.0 to 6.0.0 (#4452) @dependabot[bot]
- Bump actions/download-artifact from 6.0.0 to 7.0.0 (#4451) @dependabot[bot]
- Bump dessant/lock-threads from 5.0.1 to 6.0.0 (#4450) @dependabot[bot]
- Bump actions/cache from 4.3.0 to 5.0.1 (#4449) @dependabot[bot]
- Bump actions/checkout from 6.0.0 to 6.0.1 (#4438) @dependabot[bot]
- Bump actions/setup-python from 6.0.0 to 6.1.0 (#4437) @dependabot[bot]
- Bump actions/stale from 10.1.0 to 10.1.1 (#4439) @dependabot[bot]
- Bump actions/checkout from 5.0.0 to 6.0.0 (#4413) @dependabot[bot]
- Bump mikepenz/action-junit-report from 6.0.0 to 6.0.1 (#4379) @dependabot[bot]
- Bump actions/upload-artifact from 4.6.2 to 5.0.0 (#4364) @dependabot[bot]
- Bump actions/download-artifact from 5.0.0 to 6.0.0 (#4365) @dependabot[bot]
- Bump mikepenz/action-junit-report from 5.6.2 to 6.0.0 (#4352) @dependabot[bot]
Home Assistant OS 17.0.rc2
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
- Add eq3_char_loop patch for termios2/glibc 2.42+ compatibility (#4471) @jens-maus
- Update generic_raw_uart package to c377d91 (#4472) @jens-maus
- Update Docker to v29.1.3 (#4458) @sairon
- Update BlueZ to v5.85 (#4457) @sairon
- Bump kbd to v2.9.0, remove no longer needed gzip binary (#4456) @sairon
- Bump Buildroot to 2025.02.9 (#4455) @sairon
Home Assistant Green
Open Virtual Appliance
Generic x86-64
- Linux: Update kernel to 6.12.63 (#4474) @sairon
- Enable support of i2c-based touchscreens for x86 and aarch64 (#4463) @puterboy
Hardkernel ODROID
Khadas VIM Series
Generic aarch64
- Linux: Update kernel to 6.12.63 (#4474) @sairon
- Enable support of i2c-based touchscreens for x86 and aarch64 (#4463) @puterboy
Dependencies
- Bump mikepenz/action-junit-report from 6.0.1 to 6.1.0 (#4473) @dependabot[bot]
- Bump docker/setup-buildx-action from 3.11.1 to 3.12.0 (#4461) @dependabot[bot]
- Bump shogo82148/actions-upload-release-asset from 1.9.1 to 1.9.2 (#4466) @dependabot[bot]
- Bump dessant/label-actions from 4.0.1 to 5.0.0 (#4453) @dependabot[bot]
- Bump actions/upload-artifact from 5.0.0 to 6.0.0 (#4452) @dependabot[bot]
- Bump actions/download-artifact from 6.0.0 to 7.0.0 (#4451) @dependabot[bot]
- Bump dessant/lock-threads from 5.0.1 to 6.0.0 (#4450) @dependabot[bot]
- Bump actions/cache from 4.3.0 to 5.0.1 (#4449) @dependabot[bot]
Home Assistant OS 17.0.rc1
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
- Bump OS Agent to v1.8.1 (#4433) @sairon
- Update to Docker v29.1.2, runC v1.3.4, containerd v2.2.0 (#4429) @sairon
- Make console keymaps configurable through
localectl(#4424) @sairon - Bump OS Agent to v1.8.0 (#4420) @sairon
- Bump Buildroot to 2025.02.8 (#4415) @sairon
- Add support for QingHeng CH9200 USB ethernet adapters (#4400) @jmarshallnz
- Remove Docker patch already included in v28.5.2 (#4398) @sairon
- Use correct per-channel AppArmor profile on clean installs (#4396) @sairon
- Update to Docker v28.5.2, runC v1.3.3, containerd v2.1.5 (#4395) @sairon
- Update Go to v1.25 (#4392) @sairon
- Enable iptables comments for all targets (#4391) @monosoul
- Remove support of armv7 targets (#4374) @sairon
- Remove handling of Docker key.json (#4361) @sairon
- Use Docker containerd snapshotter for new and wiped installs (#4360) @sairon
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
- Bump actions/checkout from 6.0.0 to 6.0.1 (#4438) @dependabot[bot]
- Bump actions/setup-python from 6.0.0 to 6.1.0 (#4437) @dependabot[bot]
- Bump actions/stale from 10.1.0 to 10.1.1 (#4439) @dependabot[bot]
- Bump actions/checkout from 5.0.0 to 6.0.0 (#4413) @dependabot[bot]
- Bump mikepenz/action-junit-report from 6.0.0 to 6.0.1 (#4379) @dependabot[bot]
- Bump actions/upload-artifact from 4.6.2 to 5.0.0 (#4364) @dependabot[bot]
- Bump actions/download-artifact from 5.0.0 to 6.0.0 (#4365) @dependabot[bot]
- Bump mikepenz/action-junit-report from 5.6.2 to 6.0.0 (#4352) @dependabot[bot]
Home Assistant OS 16.3
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
- Fix Docker issue that could cause slow system startup (#4369) @sairon
- Bump Buildroot to 2025.02.7 (#4351) @sairon
- Bump rpi-rf-mod dt overlay to latest version (1.13.3) (#4349) @jens-maus
- Improve UX of HA CLI wrapper and emergency console (#4326) @sairon
- Enable HID multitouch support in kernel (#4298) @puterboy
- Update HOME_URL in os-release metadata (#4299) @sairon
- Bump Buildroot to 2025.02.6 (#4297) @sairon
- Start Supervisor container with its cidfile mounted to /run/cid (#4276) @sairon
- Enable Pressure Stall Information PSI (#4279) @ajfriesen
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
- Enable x2APIC controller support on x86 and OVA (#4342) @sairon
- Linux: Update kernel to 6.12.51 (#4343) @sairon
- Add driver for Creative Sound Blastr X-Fi PCI cards (#4331) @sairon
- Support Chelsio T4/T5/T6 VF in SRIOV mode (#4281) @servesh
Generic x86-64
- Enable x2APIC controller support on x86 and OVA (#4342) @sairon
- Enable powersave CPU frequency governor (#4346) @agners
- Linux: Update kernel to 6.12.51 (#4343) @sairon
- Add driver for Creative Sound Blastr X-Fi PCI cards (#4331) @sairon
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
- Bump actions/stale from 10.0.0 to 10.1.0 (#4338) @dependabot[bot]
- Bump docker/login-action from 3.5.0 to 3.6.0 (#4322) @dependabot[bot]
- Bump actions/cache from 4.2.4 to 4.3.0 (#4323) @dependabot[bot]
- Bump actions/github-script from 7 to 8 (#4285) @dependabot[bot]
- Bump actions/setup-python from 5 to 6 (#4284) @dependabot[bot]
- Bump actions/stale from 9.1.0 to 10.0.0 (#4283) @dependabot[bot]
Home Assistant OS 16.3.rc1
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
- Bump Buildroot to 2024.02.7 (#4351) @sairon
- Bump rpi-rf-mod dt overlay to latest version (1.13.3) (#4349) @jens-maus
- Improve UX of HA CLI wrapper and emergency console (#4326) @sairon
- Enable HID multitouch support in kernel (#4298) @puterboy
- Update HOME_URL in os-release metadata (#4299) @sairon
- Bump Buildroot to 2025.02.6 (#4297) @sairon
- Start Supervisor container with its cidfile mounted to /run/cid (#4276) @sairon
- Enable Pressure Stall Information PSI (#4279) @ajfriesen
Raspberry Pi
Home Assistant Yellow
Home Assistant Green
Open Virtual Appliance
- Enable x2APIC controller support on x86 and OVA (#4342) @sairon
- Linux: Update kernel to 6.12.51 (#4343) @sairon
- Add driver for Creative Sound Blastr X-Fi PCI cards (#4331) @sairon
- Support Chelsio T4/T5/T6 VF in SRIOV mode (#4281) @servesh
Generic x86-64
- Enable x2APIC controller support on x86 and OVA (#4342) @sairon
- Enable powersave CPU frequency governor (#4346) @agners
- Linux: Update kernel to 6.12.51 (#4343) @sairon
- Add driver for Creative Sound Blastr X-Fi PCI cards (#4331) @sairon
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
- Bump actions/stale from 10.0.0 to 10.1.0 (#4338) @dependabot[bot]
- Bump docker/login-action from 3.5.0 to 3.6.0 (#4322) @dependabot[bot]
- Bump actions/cache from 4.2.4 to 4.3.0 (#4323) @dependabot[bot]
- Bump actions/github-script from 7 to 8 (#4285) @dependabot[bot]
- Bump actions/setup-python from 5 to 6 (#4284) @dependabot[bot]
- Bump actions/stale from 9.1.0 to 10.0.0 (#4283) @dependabot[bot]
Home Assistant OS 16.2
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
- buildroot: Update BlueZ to 5.83 with connection abort fix (#4250) @bdraco
- sysctl: disable TCP slow start after idle (#4239) @RubenKelevra
- sysctl: Enable linear RTO for thin TCP streams (#4238) @RubenKelevra
- bluetooth: Increase TemporaryTimeout to 195 seconds (#4249) @bdraco
- Bump Buildroot to 2025.02.5 (#4235) @sairon
- Make system timezone setting persistenly configurable (#4224) @sairon
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
Home Assistant OS 16.2.rc2
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
Home Assistant OS 16.2.rc1
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
- buildroot: Update BlueZ to 5.83 with connection abort fix (#4250) @bdraco
- sysctl: disable TCP slow start after idle (#4239) @RubenKelevra
- sysctl: Enable linear RTO for thin TCP streams (#4238) @RubenKelevra
- bluetooth: Increase TemporaryTimeout to 195 seconds (#4249) @bdraco
- Bump Buildroot to 2025.02.5 (#4235) @sairon
- Make system timezone setting persistenly configurable (#4224) @sairon
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