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
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]