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]