Releases: home-assistant/operating-system
Release list
Home Assistant OS 18.2
Home Assistant OS 18.2 is a minor release fixing various bugs and smaller caveats. It mainly resolves networking (custom MTU) issues on Home Assistant Green and resolves eMMC/booting issues on Hardkernel ODROID-N2+. It also improves the update system integration on Raspberry Pi 5, making sure that the OS (pending) version is correctly reflected right after an update. It contains Buildroot update to 2025.02.16 which includes various security fixes and updates Docker to 29.6.2 as well.
All users are recommended to update to this Home Assistant OS release.
Read the HAOS 18.0 release notes for the noteworthy changes in this major release.
Home Assistant Operating System
- Keep Dropbear alive during Supervisor and Docker shutdown (#4923) @agners, @claude
- Do not start Supervisor from HA CLI and serial getty units (#4918) @agners, @claude
- Enable CONFIG_USB_SERIAL_XR (MaxLinear/Exar USB-to-serial) (#4915) @joelmansford
- Adapt OS update test to Supervisor no longer auto-rebooting (#4906) @agners, @claude
- Fix offline connectivity test for fancy busybox ping (#4905) @agners, @claude
- Bump Buildroot to 2025.02.16 and Docker to 29.6.2 (#4903) @agners
- Bump OS Agent to v1.10.0 (#4897) @agners
- Enable CONNMARK netfilter target and match support (#4890) @agners, @claude
- Make Supervisor startup resilient to transient network failures (#4874) @agners, @claude, @Copilot
- Enable CONFIG_FEATURE_VERBOSE_USAGE in busybox (#4853) @mhansen
- Enable CONFIG_WHICH in busybox (#4855) @mhansen
- Enable CONFIG_FEATURE_FANCY_PING in busybox (#4854) @mhansen
Raspberry Pi
- raspberrypi: Ignore UAS for Crucial X9 SSD (0634:5605) (#4893) @agners, @claude
- Make RAUC tryboot backend report staged updates on RPi 5 (#4888) @agners, @claude
Home Assistant Green
- Linux: Update kernel to 6.18.39 (#4904) @agners
- Fix Ethernet failure after runtime MTU change on stmmac devices (#4876) @agners, @claude
Open Virtual Appliance
Generic x86-64
- Enable Apple SMC hardware monitoring support (#4912) @KingKaom
- Enable Intel RAPL / powercap on generic-x86-64 (#4908) @agners, @claude
- Linux: Update kernel to 6.18.39 (#4904) @agners
- Enable Intel LPSS I2C for integrated touchscreens (#4900) @angelolsantos, @agners, @cursoragent
- Enable Intel VMD support for generic x86-64 (#4902) @andreabosman16, @codex
Hardkernel ODROID
- Linux: Update kernel to 6.18.39 (#4904) @agners
- ODROID-N2: Revert U-Boot "meson_gx_mmc: reduce maximum frequency" (#4878) @agners, @claude
- Fix Ethernet failure after runtime MTU change on stmmac devices (#4876) @agners, @claude
Khadas VIM Series
Generic aarch64
Dependencies
- Bump docker/login-action from 4.4.0 to 4.5.1 (#4921) @dependabot[bot]
- Bump actions/checkout from 7.0.0 to 7.0.1 (#4920) @dependabot[bot]
- Bump release-drafter/release-drafter from 7.5.1 to 7.6.0 (#4909) @dependabot[bot]
- Bump actions/setup-python from 6.3.0 to 7.0.0 (#4910) @dependabot[bot]
- Bump actions/stale from 10.3.0 to 10.4.0 (#4895) @dependabot[bot]
- Bump docker/setup-buildx-action from 4.1.0 to 4.2.0 (#4873) @dependabot[bot]
- Bump docker/login-action from 4.2.0 to 4.4.0 (#4872) @dependabot[bot]
- Bump docker/build-push-action from 7.2.0 to 7.3.0 (#4871) @dependabot[bot]
Contributors
Assets 37
- 343 MB
2026-07-30T13:00:26Z - 343 MB
2026-07-30T13:00:26Z - 220 MB
2026-07-30T13:00:26Z - 380 MB
2026-07-30T13:00:26Z - 380 MB
2026-07-30T13:00:26Z - 552 MB
2026-07-30T13:00:21Z - 248 MB
2026-07-30T13:00:21Z - 334 MB
2026-07-30T14:06:26Z - 193 MB
2026-07-30T14:06:26Z - 297 MB
2026-07-30T12:42:45Z -
2026-07-30T09:54:54Z -
2026-07-30T09:54:54Z - Loading
Home Assistant OS 18.2.rc1
Changes
Home Assistant Operating System
- Do not start Supervisor from HA CLI and serial getty units (#4918) @agners, @claude
- Enable CONFIG_USB_SERIAL_XR (MaxLinear/Exar USB-to-serial) (#4915) @joelmansford
- Adapt OS update test to Supervisor no longer auto-rebooting (#4906) @agners, @claude
- Fix offline connectivity test for fancy busybox ping (#4905) @agners, @claude
- Bump Buildroot to 2025.02.16 and Docker to 29.6.2 (#4903) @agners
- Bump OS Agent to v1.10.0 (#4897) @agners
- Enable CONNMARK netfilter target and match support (#4890) @agners, @claude
- Make Supervisor startup resilient to transient network failures (#4874) @agners, @claude, @Copilot
- Enable CONFIG_FEATURE_VERBOSE_USAGE in busybox (#4853) @mhansen
- Enable CONFIG_WHICH in busybox (#4855) @mhansen
- Enable CONFIG_FEATURE_FANCY_PING in busybox (#4854) @mhansen
Raspberry Pi
- raspberrypi: Ignore UAS for Crucial X9 SSD (0634:5605) (#4893) @agners, @claude
- Make RAUC tryboot backend report staged updates on RPi 5 (#4888) @agners, @claude
Home Assistant Green
- Linux: Update kernel to 6.18.39 (#4904) @agners
- Fix Ethernet failure after runtime MTU change on stmmac devices (#4876) @agners, @claude
Open Virtual Appliance
Generic x86-64
- Enable Apple SMC hardware monitoring support (#4912) @KingKaom
- Enable Intel RAPL / powercap on generic-x86-64 (#4908) @agners, @claude
- Linux: Update kernel to 6.18.39 (#4904) @agners
- Enable Intel LPSS I2C for integrated touchscreens (#4900) @angelolsantos, @agners, @cursoragent
- Enable Intel VMD support for generic x86-64 (#4902) @andreabosman16, @codex
Hardkernel ODROID
- Linux: Update kernel to 6.18.39 (#4904) @agners
- ODROID-N2: Revert U-Boot "meson_gx_mmc: reduce maximum frequency" (#4878) @agners, @claude
- Fix Ethernet failure after runtime MTU change on stmmac devices (#4876) @agners, @claude
Khadas VIM Series
Generic aarch64
Dependencies
- Bump release-drafter/release-drafter from 7.5.1 to 7.6.0 (#4909) @dependabot[bot]
- Bump actions/setup-python from 6.3.0 to 7.0.0 (#4910) @dependabot[bot]
- Bump actions/stale from 10.3.0 to 10.4.0 (#4895) @dependabot[bot]
- Bump docker/setup-buildx-action from 4.1.0 to 4.2.0 (#4873) @dependabot[bot]
- Bump docker/login-action from 4.2.0 to 4.4.0 (#4872) @dependabot[bot]
- Bump docker/build-push-action from 7.2.0 to 7.3.0 (#4871) @dependabot[bot]
Contributors
Assets 37
Home Assistant OS 18.1
Home Assistant OS 18.1 is a minor release on top of 18.0. It resolves the Raspberry Pi 5 display freeze on older firmware that was present in 18.0, and brings broader Intel hardware support along with incremental Linux kernel updates across all platforms.
All users are recommended to update to this Home Assistant OS release.
Read the HAOS 18.0 release notes for the noteworthy changes in this major release.
Home Assistant Operating System
- Enable iwlmld driver for Wi-Fi 7 Intel devices (#4809) @agners
- busybox: Disable seedrng applet (#4836) @agners
- busybox: Drop unused netstat applet (#4835) @agners
- Add usage to busybox utils (#4831) @mhansen
- Remove timeout from data partition resize service (#4821) @agners
Raspberry Pi
Note
The Home Assistant OS 18.0 release has been removed from the stable channel (since OS updates are not working on old firmware and due to #4811). For users who already updated to HAOS 18.0, you may need to upgrade the Raspberry Pi 5 firmware using ha os boards raspberrypi firmware update before upgrading to the next Home Assistant OS release.
Note
The default graphics (DRM) driver on Raspberry Pi 4 has been switched from the legacy, no longer maintained FKMS driver to the modern KMS driver, which among other things enables HDMI-CEC support. This only applies to new installations. On existing ones, config.txt in the boot partition must be adjusted manually to make the switch.
Home Assistant Yellow
Note
The Home Assistant OS 18.0 release has been removed from the stable channel (since OS updates are not working on old firmware and due to #4811). For users who already updated to HAOS 18.0, you may need to upgrade the CM5 firmware using ha os boards raspberrypi firmware update before upgrading to the next Home Assistant OS release. This does not apply for Yellow with CM4.
Note
Currently, Raspberry Pi Firmware updates are not supported on Yellow with CM4. The reason reported is currently unsupported_boot_device, which is not correct. That said, updating the Raspberry Pi firmware is not required on a CM4.
Home Assistant Green
Open Virtual Appliance
- Add Intel BZ and SC WiFi firmware (#4837) @agners
- Enable CONFIG_BT_INTEL_PCIE for Intel PCIe Bluetooth (#4834) @agners
- Linux: Update kernel to 6.18.37 (#4833) @agners
- Enable Intel NPU driver (ivpu) for x86-64 boards (#4816) @agners
Generic x86-64
- Add Intel BZ and SC WiFi firmware (#4837) @agners
- Enable CONFIG_BT_INTEL_PCIE for Intel PCIe Bluetooth (#4834) @agners
- Linux: Update kernel to 6.18.37 (#4833) @agners
- Enable Intel NPU driver (ivpu) for x86-64 boards (#4816) @agners
Hardkernel ODROID
Warning
There have been reports with HAOS 18.0 that the system was no longer bootable after the upgrade (see #4786 and #4788). So far we have not been able to reproduce the issue, and it seems to affect only a small subset of devices. Make sure to create a full backup and download it before upgrading the to latest version, just in case. If you run into the issue and are able to assist debugging the issue, please speak up on the issue tracker.
- Linux: Update kernel to 6.18.37 (#4833) @agners
- ODROID-N2: Fall back to other slot when a kernel fails to load (#4832) @agners
Khadas VIM Series
Generic aarch64
- Add Intel BZ and SC WiFi firmware (#4837) @agners
- Enable CONFIG_BT_INTEL_PCIE for Intel PCIe Bluetooth (#4834) @agners
- Linux: Update kernel to 6.18.37 (#4833) @agners
Dependencies
Dependency updates (click to expand)
- Bump actions/cache/save from 5.0.5 to 6.1.0 (#4841) @dependabot[bot]
- Bump actions/setup-python from 6.2.0 to 6.3.0 (#4840) @dependabot[bot]
- Bump release-drafter/release-drafter from 7.4.0 to 7.5.1 (#4839) @dependabot[bot]
- Bump actions/cache/restore from 5.0.5 to 6.1.0 (#4838) @dependabot[bot]
- Bump shogo82148/actions-upload-release-asset from 1.10.1 to 1.10.2 (#4797) @dependabot[bot]
- Bump release-drafter/release-drafter from 7.3.1 to 7.4.0 (#4798) @dependabot[bot]
- Bump actions/checkout from 6.0.3 to 7.0.0 (#4799) @dependabot[bot]
- Bump mikepenz/action-junit-report from 6.4.1 to 6.4.2 (#4800) @dependabot[bot]
Contributors
Assets 37
Home Assistant OS 18.1.rc1
Home Assistant OS 18.1.rc1 is a minor release on top of 18.0. It resolves the Raspberry Pi 5 display freeze on older firmware that was present in 18.0, and brings broader Intel hardware support along with incremental Linux kernel updates across all platforms. All users are recommended to update.
Home Assistant Operating System
- Enable iwlmld driver for Wi-Fi 7 Intel devices (#4809) @agners
- busybox: Disable seedrng applet (#4836) @agners
- busybox: Drop unused netstat applet (#4835) @agners
- Add usage to busybox utils (#4831) @mhansen
- Remove timeout from data partition resize service (#4821) @agners
Raspberry Pi
Home Assistant Yellow
Home Assistant Green
Open Virtual Appliance
- Add Intel BZ and SC WiFi firmware (#4837) @agners
- Enable CONFIG_BT_INTEL_PCIE for Intel PCIe Bluetooth (#4834) @agners
- Linux: Update kernel to 6.18.37 (#4833) @agners
- Enable Intel NPU driver (ivpu) for x86-64 boards (#4816) @agners
Generic x86-64
- Add Intel BZ and SC WiFi firmware (#4837) @agners
- Enable CONFIG_BT_INTEL_PCIE for Intel PCIe Bluetooth (#4834) @agners
- Linux: Update kernel to 6.18.37 (#4833) @agners
- Enable Intel NPU driver (ivpu) for x86-64 boards (#4816) @agners
Hardkernel ODROID
- Linux: Update kernel to 6.18.37 (#4833) @agners
- ODROID-N2: Fall back to other slot when a kernel fails to load (#4832) @agners
Khadas VIM Series
Generic aarch64
- Add Intel BZ and SC WiFi firmware (#4837) @agners
- Enable CONFIG_BT_INTEL_PCIE for Intel PCIe Bluetooth (#4834) @agners
- Linux: Update kernel to 6.18.37 (#4833) @agners
Dependencies
- Bump actions/cache/save from 5.0.5 to 6.1.0 (#4841) @dependabot[bot]
- Bump actions/setup-python from 6.2.0 to 6.3.0 (#4840) @dependabot[bot]
- Bump release-drafter/release-drafter from 7.4.0 to 7.5.1 (#4839) @dependabot[bot]
- Bump actions/cache/restore from 5.0.5 to 6.1.0 (#4838) @dependabot[bot]
- Bump shogo82148/actions-upload-release-asset from 1.10.1 to 1.10.2 (#4797) @dependabot[bot]
- Bump release-drafter/release-drafter from 7.3.1 to 7.4.0 (#4798) @dependabot[bot]
- Bump actions/checkout from 6.0.3 to 7.0.0 (#4799) @dependabot[bot]
- Bump mikepenz/action-junit-report from 6.4.1 to 6.4.2 (#4800) @dependabot[bot]
Contributors
Assets 37
Home Assistant OS 18.0
Home Assistant OS 18.0 is a major release bringing significant updates to all platforms. The Linux kernel has been updated from 6.12 to 6.18 across all targets, Docker has been upgraded to v29.5.3 with containerd v2.2.4, and the underlying Buildroot has been updated to 2025.02.14. Disk images are now significantly faster to flash, the default swap size is now bounded to avoid problems on systems with very low or very high amounts of RAM, and the Raspberry Pi bootloader firmware can now be updated directly from Home Assistant. All users are recommended to update.
Noteworthy changes
Raspberry Pi firmware updates
The Raspberry Pi bootloader (EEPROM) firmware can now be checked and updated directly from Home Assistant OS. Use the following CLI commands to show the current firmware status and to install an update:
ha os boards raspberrypi firmware
ha os boards raspberrypi firmware update
Home Assistant Core 2026.7.0 will also expose the firmware as an update entity. Note that on Raspberry Pi 3 and 4 updating the firmware is only possible when the system is booted from an SD card.
Note that Rasbperry Pi 5 now requires firmware 2025-02-12 or newer. See the Raspberry Pi section below for details.
Default swap size
The default swap file size was previously set to 33% of the system RAM, which produced a swap file too small to be useful on low-RAM systems and an unnecessarily large one on systems with plenty of RAM. The default size is now clamped between 1 and 4 GB:
- On systems with up to 2 GB of RAM, the swap file will grow slightly compared to previous releases.
- On systems with more than 12 GB of RAM, the swap file is capped at 4 GB, and an existing oversized swap file will be recreated at the smaller size.
- A manually configured swap size is still respected.
Leaner disk images and faster flashing
Disk images no longer overprovision the data partition, it is now sized to fit only its initial contents. Since the published images are compressed, the download size is not affected, but flashing is considerably faster, because the unused space at the end of the filesystem no longer needs to be written to the target storage. As before, the data partition is automatically expanded to use the available space on first boot.
Images for virtual machines (Open Virtual Appliance and the aarch64 VM formats) are pre-sized to 32 GB, so they no longer need to be resized before use.
Unified "haos" naming
The mix of legacy hassos/HassOS and newer haos naming across the operating system has been harmonized to haos. Most visibly, systemd units and helper binaries previously prefixed hassos- are now prefixed haos-. If you have scripts or tooling that reference these names on the host (for example via the console or host logs), they may need adjusting. On-disk partition and filesystem labels are unchanged, so existing installations are not affected by the rename.
Smoother first boot and landing page
The landing page, shown during the initial setup before Home Assistant Core has finished installing, has received a number of improvements that make the first boot easier to follow.
Downloading and installing Core on a fresh system can take a while, especially on slower connections, and until now the landing page gave no indication of how far along the process was. It now shows a progress bar while Core is being downloaded, so it is clear that something is happening and roughly how much is left.
The initial mDNS announcements during the first boot have also been fixed. The device now announces itself correctly from the start, so it can be discovered in the mobile apps right away while the system is still setting itself up, without having to wait for the Core installation to complete.
Home Assistant Operating System
- Enable usbip on all targets (#4776) @pvizeli
- Shrink data partition for leaner disk images and faster flashing (#4764) @sairon
- Enable NFS v4.1/v4.2 for all targets (#4762) @sairon
- Clamp default swap size between 1-4 GB (#4758) @sairon
- Update Docker to v29.5.3 (#4755) @sairon
- Harmonize hassos/HassOS naming to haos across the tree (#4740) @sairon
- Drop
_workstation._tcpservice annoucement from HAOS (#4739) @agners - Extend hassos-supervisor.service stop timeout for graceful shutdown (#4736) @sairon
- Bump OS Agent to v1.9.0 (#4724) @sairon
- Update to Docker v29.5.2, containerd v2.2.4 (#4723) @sairon
- Update Go to v1.26 (#4722) @sairon
- Bump Buildroot to 2025.02.14 (#4721) @sairon
- Bump nfs-utils to fix nfsrahead crashes (#4709) @sairon
- systemd: Increase runtime watchdog timeout to 5 minutes (#4705) @agners
- Bump Buildroot to 2025.02.13 (#4689) @sairon
- Enable IPv6 on Docker default bridge (#4678) @agners
- Update linux-firmware to 20260410 (#4668) @sairon
- Update v4l2loopback to v0.15.3 (#4648) @sairon
- Bump rpi-rf-mod to 1.14.0 (#4644) @jens-maus
- Bump generic-raw-uart to 1.33 and add kernel 6.14+ patches (#4643) @jens-maus
- Update Go to v1.25.9 (#4645) @sairon
- Update to Docker v29.3.1, runC v1.3.5, containerd v2.2.2 (#4614) @sairon
- Update Go to v1.25.8 (#4612) @sairon
- Add patches with fixes for Docker engine (#4605) @agners
Raspberry Pi
Note
The Home Assistant OS 18.0 release has been removed from the stable channel (since OS updates are not working on old firmware and due to #4811). For users who already updated to HAOS 18.0, make sure to upgrade the Raspberry Pi 5 firmware using ha os boards raspberrypi firmware update before running the next Home Assistant OS update.
Important
Raspberry Pi 5 users need a bootloader from at least 2025-02-12, otherwise the display output may stop working early during the boot. You can update after installing the Home Assistant OS 18 update but you won't have display output in case the update fails. So if you decide to update first, make a backup and download it just in case.
- After the update, use the SSH terminal app and run
ha os boards raspberrypi firmware updateover SSH to make the display output work again.
To update the bootloader before installing Home Assistant OS 18, use one of the following methods:
- Use
loginto get to the OS prompt, then runrpi-eeprom-update -awhile connected directly to the device (using a display and keyboard), prior to installing the OS update. - Use Raspberry Pi Imager with a spare SD card to flash a bootloader update image to it.
The Yellow with CM5 has no display output and is therefor not affected from this problem.
Note
The default graphics (DRM) driver on Raspberry Pi 4 has been switched from the legacy, no longer maintained FKMS driver to the modern KMS driver, which among other things enables HDMI-CEC support. This only applies to new installations. On existing ones, config.txt in the boot partition must be adjusted manually to make the switch.
- Enable PSI by default also on Raspberry Pi (#4749) @sairon
- RaspberryPi: Update kernel to 6.18.33 (stable_20260527) (#4737, #4748) @sairon
- Patch rpi-eeprom-update to show info on CM4 and make findBootFS faster (#4735) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Show if flashrom needs to be used by rpi-eeprom-update in tool output (#4718) @sairon
- Update bundled RPi bootloader to 2026-01-09 (2711)/2026-05-11 (2712) (#4715) @sairon
- Enable pciutils on RPi4/RPi5-based targets (#4703) @sairon
- Update U-Boot to v2026.04 (#4685) @sairon
- Switch Raspberry Pi 4 default DRM driver from legacy FKMS to KMS (#4661) @zekiz774
- Disable UAS for RTL9201 (UGREEN USB3.0 HDD enclosure) (#4610) @KlaraJa
Home Assistant Yellow
Note
The Home Assistant OS 18.0 release has been removed from the stable channel (since OS updates are not working on old firmware and due to #4811). For users who already updated to HAOS 18.0, make sure to upgrade the Yellow CM5 firmware using ha os boards raspberrypi firmware update before running the next Home Assistant OS update.
Note
Currently, Raspberry Pi Firmware updates are not supported on Yellow with CM4. The reason reported is currently unsupported_boot_device, which is not correct.
- Enable PSI by default also on Raspberry Pi (#4749) @sairon
- RaspberryPi: Update kernel to 6.18.33 (stable_20260527) (#4737, #4748) @sairon
- Patch rpi-eeprom-update to show info on CM4 and make findBootFS faster (#4735) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Show if flashrom needs to be used by rpi-eeprom-update in tool output (#4718) @sairon
- Update bundled RPi bootloader to 2026-01-09 (2711)/2026-05-11 (2712) (#4715) @sairon
- Squash Yellow DTS patches (#4710) @sairon
- Backport U-Boot patch for Raspberry Pi MMC init on BCM2712 (#4707) @sairon
- Enable pciutils on RPi4/RPi5-based targets (#4703) @sairon
- Update U-Boot to v2026.04 (#4685) @sairon
Home Assistant Green
- Build NFS as built-in module consistently on all targets (#4773) @sairon
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4662, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Update U-Boot to v2026.04 (#4685) @sairon
Open Virtual Appliance
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4650, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Enable JMicron PCIe NIC driver (#4756) @MaxPowerFood
- Enable Intel Xe DRM driver and firmware (#4750) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Add RTL8125D rev.b firmware (#4675) @sairon
Generic x86-64
- Linux: Update kerne...
Contributors
Assets 37
Home Assistant OS 18.0.rc1
Home Assistant OS 18.0 is a major release bringing significant updates to all platforms. The Linux kernel has been updated from 6.12 to 6.18 across all targets, Docker has been upgraded to v29.5.3 with containerd v2.2.4, and the underlying Buildroot has been updated to 2025.02.14. Disk images are now significantly faster to flash, the default swap size is now bounded to avoid problems on systems with very low or very high amounts of RAM, and the Raspberry Pi bootloader firmware can now be updated directly from Home Assistant. All users are recommended to update.
Noteworthy changes
Raspberry Pi firmware updates
The Raspberry Pi bootloader (EEPROM) firmware can now be checked and updated directly from Home Assistant OS. Use the following CLI commands to show the current firmware status and to install an update:
ha os boards raspberrypi firmware
ha os boards raspberrypi firmware update
Home Assistant Core 2026.7.0 will also expose the firmware as an update entity. Note that updating the firmware is only possible when the system is booted from an SD card, or in general on Raspberry Pi 5 and on Home Assistant Yellow with a CM5.
Note that Rasbperry Pi 5 now requires firmware 2025-02-12 or newer. See the Raspberry Pi section below for details.
Default swap size
The default swap file size was previously set to 33% of the system RAM, which produced a swap file too small to be useful on low-RAM systems and an unnecessarily large one on systems with plenty of RAM. The default size is now clamped between 1 and 4 GB:
- On systems with up to 2 GB of RAM, the swap file will grow slightly compared to previous releases.
- On systems with more than 12 GB of RAM, the swap file is capped at 4 GB, and an existing oversized swap file will be recreated at the smaller size.
- A manually configured swap size is still respected.
Leaner disk images and faster flashing
Disk images no longer overprovision the data partition, it is now sized to fit only its initial contents. Since the published images are compressed, the download size is not affected, but flashing is considerably faster, because the unused space at the end of the filesystem no longer needs to be written to the target storage. As before, the data partition is automatically expanded to use the available space on first boot.
Images for virtual machines (Open Virtual Appliance and the aarch64 VM formats) are pre-sized to 32 GB, so they no longer need to be resized before use.
Unified "haos" naming
The mix of legacy hassos/HassOS and newer haos naming across the operating system has been harmonized to haos. Most visibly, systemd units and helper binaries previously prefixed hassos- are now prefixed haos-. If you have scripts or tooling that reference these names on the host (for example via the console or host logs), they may need adjusting. On-disk partition and filesystem labels are unchanged, so existing installations are not affected by the rename.
Home Assistant Operating System
- Shrink data partition for leaner disk images and faster flashing (#4764) @sairon
- Enable NFS v4.1/v4.2 for all targets (#4762) @sairon
- Clamp default swap size between 1-4 GB (#4758) @sairon
- Update Docker to v29.5.3 (#4755) @sairon
- Harmonize hassos/HassOS naming to haos across the tree (#4740) @sairon
- Drop
_workstation._tcpservice annoucement from HAOS (#4739) @agners - Extend hassos-supervisor.service stop timeout for graceful shutdown (#4736) @sairon
- Bump OS Agent to v1.9.0 (#4724) @sairon
- Update to Docker v29.5.2, containerd v2.2.4 (#4723) @sairon
- Update Go to v1.26 (#4722) @sairon
- Bump Buildroot to 2025.02.14 (#4721) @sairon
- Bump nfs-utils to fix nfsrahead crashes (#4709) @sairon
- systemd: Increase runtime watchdog timeout to 5 minutes (#4705) @agners
- Bump Buildroot to 2025.02.13 (#4689) @sairon
- Enable IPv6 on Docker default bridge (#4678) @agners
- Update linux-firmware to 20260410 (#4668) @sairon
- Update v4l2loopback to v0.15.3 (#4648) @sairon
- Bump rpi-rf-mod to 1.14.0 (#4644) @jens-maus
- Bump generic-raw-uart to 1.33 and add kernel 6.14+ patches (#4643) @jens-maus
- Update Go to v1.25.9 (#4645) @sairon
- Update to Docker v29.3.1, runC v1.3.5, containerd v2.2.2 (#4614) @sairon
- Update Go to v1.25.8 (#4612) @sairon
- Add patches with fixes for Docker engine (#4605) @agners
Raspberry Pi
Warning
Raspberry Pi 5 users need a bootloader from at least 2025-02-12, otherwise the display output may freeze early during the boot. Update the bootloader before installing this update, using one of the following methods:
- Run
rpi-eeprom-update -awhile connected directly to the device (using a display and keyboard), prior to installing the OS update. - Use Raspberry Pi Imager with a spare SD card to flash a bootloader update image to it.
- Alternatively, if you have an SSH terminal app installed, you can run
ha os boards raspberrypi firmware updateover SSH right after updating the OS.
Note
The default graphics (DRM) driver on Raspberry Pi 4 has been switched from the legacy, no longer maintained FKMS driver to the modern KMS driver, which among other things enables HDMI-CEC support. This only applies to new installations. On existing ones, config.txt in the boot partition must be adjusted manually to make the switch.
- Enable PSI by default also on Raspberry Pi (#4749) @sairon
- RaspberryPi: Update kernel to 6.18.33 (stable_20260527) (#4737, #4748) @sairon
- Patch rpi-eeprom-update to show info on CM4 and make findBootFS faster (#4735) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Show if flashrom needs to be used by rpi-eeprom-update in tool output (#4718) @sairon
- Update bundled RPi bootloader to 2026-01-09 (2711)/2026-05-11 (2712) (#4715) @sairon
- Enable pciutils on RPi4/RPi5-based targets (#4703) @sairon
- Update U-Boot to v2026.04 (#4685) @sairon
- Switch Raspberry Pi 4 default DRM driver from legacy FKMS to KMS (#4661) @zekiz774
- Disable UAS for RTL9201 (UGREEN USB3.0 HDD enclosure) (#4610) @KlaraJa
Home Assistant Yellow
- Enable PSI by default also on Raspberry Pi (#4749) @sairon
- RaspberryPi: Update kernel to 6.18.33 (stable_20260527) (#4737, #4748) @sairon
- Patch rpi-eeprom-update to show info on CM4 and make findBootFS faster (#4735) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Show if flashrom needs to be used by rpi-eeprom-update in tool output (#4718) @sairon
- Update bundled RPi bootloader to 2026-01-09 (2711)/2026-05-11 (2712) (#4715) @sairon
- Squash Yellow DTS patches (#4710) @sairon
- Backport U-Boot patch for Raspberry Pi MMC init on BCM2712 (#4707) @sairon
- Enable pciutils on RPi4/RPi5-based targets (#4703) @sairon
- Update U-Boot to v2026.04 (#4685) @sairon
Home Assistant Green
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4662, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Update U-Boot to v2026.04 (#4685) @sairon
Open Virtual Appliance
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4650, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Enable JMicron PCIe NIC driver (#4756) @MaxPowerFood
- Enable Intel Xe DRM driver and firmware (#4750) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Add RTL8125D rev.b firmware (#4675) @sairon
Generic x86-64
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4650, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Enable JMicron PCIe NIC driver (#4756) @MaxPowerFood
- Enable Intel Xe DRM driver and firmware (#4750) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Add RTL8125D rev.b firmware (#4675) @sairon
Hardkernel ODROID
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4662, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Update U-Boot to v2026.04 (#4685) @sairon
- Fix ODROID-C2 USB hotplug (#4669) @agners
Khadas VIM Series
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4662, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Update U-Boot to v2026.04 (#4685) @sairon
Generic aarch64
- Linux: Update kernel to 6.18.35 (#4621, #4646, #4662, #4664, #4674, #4691, #4700, #4711, #4720, #4728, #4747, #4759) @sairon
- Add firmware for MediaTek MT7920 Bluetooth and WiFi (#4729) @sairon
- Enable MT7925 Bluetooth firmware (#4726) @jelliuk
- Add RTL8125D rev.b firmware (#4675) @sairon
Build System
- Add CAs for new signing certificates to RAUC keyring (#4757) @sairon
- Add CI check for sufficient validity of the OTA signing certificate (#4751) @sairon
- Fix OS update tests when update returns no response (#4741) @sairon
- Update build container to Debian Trixie (#4701) @sairon
- Allow enter.sh to run without TTY (#4686) @sairon
- Add support for transitional attribute to kconfiglib (#4649) @sairon
Documentation
Dependencies
Dependency updates (click to expand)
- Bump release-drafter/release-drafter from 7.3.0 to 7.3.1 (#4746) @dependabot[bot]
- Bump actions/checkout from 6.0....
Contributors
Assets 37
Home Assistant OS 17.3
Changes
Home Assistant Operating System 17.3 is a security release that only updates the Linux kernel to the latest version. For Raspberry Pi targets, the relevant algif_aead fixes for CVE-2026-31431 (Copy Fail) have been explicitly backported.
Note
In practice, most parts of a Home Assistant Operating System installation are not meaningfully affected by this vulnerability: Home Assistant Operating System is a single-application appliance, and Home Assistant's security model expects that logged-in users are trusted and does not rely on separating trusted local users from each other. Most parts (including Home Assistant Core and custom components) already run as root. Fixing this CVE only meaningfully improves the security posture for apps (formerly add-ons) that intentionally drop privileges (apps running as a non-root user).
Raspberry Pi
Home Assistant Yellow
Home Assistant Green
Open Virtual Appliance
Generic x86-64
Hardkernel ODROID
Khadas VIM Series
Generic aarch64
Contributors
Assets 37
Home Assistant OS 17.3.rc1
Changes
Home Assistant Operating System 17.3 is a security release that only updates the Linux kernel to the latest version. For Raspberry Pi targets, the relevant algif_aead fixes for CVE-2026-31431 (Copy Fail) have been explicitly backported.
Note
In practice, most parts of a Home Assistant Operating System installation are not meaningfully affected by this vulnerability: Home Assistant Operating System is a single-application appliance, and Home Assistant's security model expects that logged-in users are trusted and does not rely on separating trusted local users from each other. Most parts (including Home Assistant Core and custom components) already run as root. Fixing this CVE only meaningfully improves the security posture for apps (formerly add-ons) that intentionally drop privileges (apps running as a non-root user).
Raspberry Pi
Home Assistant Yellow
Home Assistant Green
Open Virtual Appliance
Generic x86-64
Hardkernel ODROID
Khadas VIM Series
Generic aarch64
Contributors
Assets 37
Home Assistant OS 17.2
Changes
Home Assistant OS 17.2 brings Buildroot 2025.02.12, Docker v29.3.1, and various reliability improvements. Wi-Fi powersave is now disabled by default for all connections to improve wireless stability. The number of DNS queries from connectivity checks has been reduced, and sets foundation to allow the Supervisor more time for graceful shutdown during system power-off. The Linux kernel has been updated to the latest stable version across all targets. This is the last planned release of 17.x series using the Linux kernel 6.12. All users are encouraged to upgrade.
Home Assistant Operating System
- Update to Docker v29.3.1, runC v1.3.5, containerd v2.2.2 (#4614) @sairon
- Update Go to v1.25.8 (#4612) @sairon
- Add patches with fixes for Docker engine (#4605) @agners
- Bump Buildroot to 2025.02.12 (#4593) @sairon
- Drop explicit IPv6 forwarding sysctl (#4589) @agners
- logind: Set InhibitDelayMaxSec=300 to allow Supervisor graceful shutdown (#4577) @agners
- Reduce number of DNS queries from connectivity checks (#4571) @sairon
- Update Go to v1.25.7 (#4557) @sairon
- Disable Wi-Fi powersave by default for all connections (#4529) @sairon
Raspberry Pi
Warning
Older versions of Raspberry Pi 4B (Rev 1.4) may be using an old EEPROM bootloader which results in USB devices becoming unavailable after the update to HAOS 17.2. While reverting to 17.1 works around the issue, it is strongly recommended to perform update of the bootloader. See issue #4627 for details on suggested fixes and workarounds.
- Fix rpi-eeprom-config when booting RPi 5 from NVMe (#4586) @sairon
- RaspberryPi: Update kernel to 6.12.75 (#4591) @sairon
Home Assistant Yellow
- Fix rpi-eeprom-config when booting RPi 5 from NVMe (#4586) @sairon
- RaspberryPi: Update kernel to 6.12.75 (#4591) @sairon
Home Assistant Green
Open Virtual Appliance
Generic x86-64
Hardkernel ODROID
Khadas VIM Series
Generic aarch64
Build System
- Fix handling of hassio container updates in tests (#4599) @sairon
- Fix skopeo for ARM images in hassio after builder changes (#4594) @sairon
- Update labgrid and test dependencies, add .python-version (#4583) @sairon
- Fix retry in hassio container fetching, retry with backoff (#4572) @sairon
- Do not archive OS image artifacts for unpublished builds (#4565) @sairon
- Wait for Core to install and start in Supervisor tests (#4544) @sairon
Documentation
Dependencies
- Bump release-drafter/release-drafter from 7.0.0 to 7.1.1 (#4597) @dependabot[bot]
- Bump actions/cache from 5.0.3 to 5.0.4 (#4598) @dependabot[bot]
- Bump shogo82148/actions-upload-release-asset from 1.9.2 to 1.10.0 (#4579) @dependabot[bot]
- Bump actions/download-artifact from 8.0.0 to 8.0.1 (#4580) @dependabot[bot]
- Bump release-drafter/release-drafter from 6.4.0 to 7.0.0 (#4581) @dependabot[bot]
- Bump release-drafter/release-drafter from 6.2.0 to 6.4.0 (#4570) @dependabot[bot]
- Bump docker/setup-buildx-action from 3.12.0 to 4.0.0 (#4569) @dependabot[bot]
- Bump docker/login-action from 3.7.0 to 4.0.0 (#4568) @dependabot[bot]
- Bump docker/build-push-action from 6.19.2 to 7.0.0 (#4567) @dependabot[bot]
- Bump actions/download-artifact from 7.0.0 to 8.0.0 (#4561) @dependabot[bot]
- Bump actions/upload-artifact from 6.0.0 to 7.0.0 (#4562) @dependabot[bot]
- Bump mikepenz/action-junit-report from 6.2.0 to 6.3.1 (#4563) @dependabot[bot]
- Bump actions/stale from 10.1.1 to 10.2.0 (#4551) @dependabot[bot]
- Bump docker/build-push-action from 6.18.0 to 6.19.2 (#4541) @dependabot[bot]
Contributors
Assets 37
Home Assistant OS 17.2.rc2
Changes
This release contains the following list of various updates since the previous beta release. See 17.2.rc2 release notes for the list of changes since the latest stable release.