Software-update: Home Assistant OS 17.0

Versie 17.0 van Home Assistant OS is uitgekomen. Home Assistant OS is een minimaal, op Buildroot gebaseerd besturingssysteem dat het mogelijk maakt om op een fysieke of virtuele machine Home Assistant te draaien. In versie 17.0 komt ondersteuning voor oudere 32bit-hardware te vervallen en is voor nieuwe installaties nu Docker containerd snapshotter als standaard ingesteld. De complete changelog voor deze uitgave ziet er als volgt uit:

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)
• Update generic_raw_uart package to c377d91 (#4472)
• Update Docker to v29.1.3 (#4458)
• Update BlueZ to v5.85 (#4457)
• Bump kbd to v2.9.0, remove no longer needed gzip binary (#4456)
• Bump Buildroot to 2025.02.9 (#4455)
• Bump OS Agent to v1.8.1 (#4433)
• Update to Docker v29.1.2, runC v1.3.4, containerd v2.2.0 (#4429)
• Make console keymaps configurable through localectl (#4424)
• Bump OS Agent to v1.8.0 (#4420)
• Bump Buildroot to 2025.02.8 (#4415)
• Add support for QingHeng CH9200 USB ethernet adapters (#4400)
• Remove Docker patch already included in v28.5.2 (#4398)
• Use correct per-channel AppArmor profile on clean installs (#4396)
• Update to Docker v28.5.2, runC v1.3.3, containerd v2.1.5 (#4395)
• Update Go to v1.25 (#4392)
• Enable iptables comments for all targets (#4391)
• Remove support of armv7 targets (#4374)
• Remove handling of Docker key.json (#4361)
• Use Docker containerd snapshotter for new and wiped installs (#4360)

Raspberry Pi

• Remove support of armv7 targets (#4374)

Home Assistant Green

• Linux: Update kernel to 6.12.63 (#4474)

Open Virtual Appliance

• Linux: Update kernel to 6.12.63 (#4474)

Generic x86-64

• Linux: Update kernel to 6.12.63 (#4474)
• Enable support of i2c-based touchscreens for x86 and aarch64 (#4463)

Hardkernel ODROID

• Linux: Update kernel to 6.12.63 (#4474)
• Remove support of armv7 targets (#4374)

Khadas VIM Series

• Linux: Update kernel to 6.12.63 (#4474)

Generic aarch64

• Linux: Update kernel to 6.12.63 (#4474)
• Enable support of i2c-based touchscreens for x86 and aarch64 (#4463)

Build System

• Remove deprecated boards from build matrix and .github templates (#4399)
• Clean up hassio build scripts (#4394)
• Use OCI archive in hassio import to fix Containerd snapshotter issues (#4393)
• Fix tests to accommodate wait for container re-download on downgrade (#4368)

Dependencies

• Bump mikepenz/action-junit-report from 6.0.1 to 6.1.0 (#4473)
• Bump docker/setup-buildx-action from 3.11.1 to 3.12.0 (#4461)
• Bump shogo82148/actions-upload-release-asset from 1.9.1 to 1.9.2 (#4466)
• Bump dessant/label-actions from 4.0.1 to 5.0.0 (#4453)
• Bump actions/upload-artifact from 5.0.0 to 6.0.0 (#4452)
• Bump actions/download-artifact from 6.0.0 to 7.0.0 (#4451)
• Bump dessant/lock-threads from 5.0.1 to 6.0.0 (#4450)
• Bump actions/cache from 4.3.0 to 5.0.1 (#4449)
• Bump actions/checkout from 6.0.0 to 6.0.1 (#4438)
• Bump actions/setup-python from 6.0.0 to 6.1.0 (#4437)
• Bump actions/stale from 10.1.0 to 10.1.1 (#4439)
• Bump actions/checkout from 5.0.0 to 6.0.0 (#4413)
• Bump mikepenz/action-junit-report from 6.0.0 to 6.0.1 (#4379)
• Bump actions/upload-artifact from 4.6.2 to 5.0.0 (#4364)
• Bump actions/download-artifact from 5.0.0 to 6.0.0 (#4365)
• Bump mikepenz/action-junit-report from 5.6.2 to 6.0.0 (#4352)

Versienummer	17.0
Releasestatus	Final
Besturingssystemen	Linux
Website	Home Assistant
Download	https://github.com/home-assistant/operating-system/releases/tag/17.0
Licentietype	Voorwaarden (GNU/BSD/etc.)

Reacties (48)

[Zorian]

Voor degenen die zich afvragen of je op 32bit draait (gezien ze de ondersteuning hiervoor eruit trekken), ga naar settings en dan add-ons. In de store (blauwe knop rechtsonder) kan je de app "Terminal & SSH" downloaden. Na installatie start je die, en ga je erheen via de blauwe knop "Open Web UI". Voer dan dit in en druk op enter:

uname -m

Als je "aarch64" terug krijgt zit je al op 64bit en is er niks aan de hand.

[Reactie gewijzigd door Zorian op 19 januari 2026 13:36]

[JP1980]

Deze standaard HA kaart toont ook de architectuur: (bij mij x86_64)

Instellingen --> Repairs --> [ 3 puntjes rechtsbovenin ] --> System Information --> CPU Archtectuur

[bleuthoot]

Snelle link voor de luie mensen:

https://my.home-assistant.io/redirect/system_health/

[xoniq]

CPU-architectuur x86_64

Jup. Blijft mooi dat 'my.home-assistant.io' linkje. Als je die ooit een keer gekoppeld hebt aan je eigen install is dat wel echt makkelijk.

[Zorian]

Dat is inderdaad zo te zien ook een manier, eentje die ik nog niet wist. Goede toevoeging! Ook een snellere manier.

[TheFes]

In principe kun je 32 bits HA op een 64 bits CPU draaien. Dus als je een 64 bits CPU hebt, geeft je dat nog geen garantie dat HA install ondersteund blijft.

[proostyves]

En als je het volgende terug krijgt?
x86_64

[Zorian]

Dan gok ik dat ie ook 64bits is, maar dan draai je het niet op een Pi in elk geval vermoed ik.

[mcmd]

Waarom niet? Dat kan prima hoor. Doe ik ook op een raspberry pi 4, met daarnaast smokeping, pihole, stirling-pdf, nginx, …

Wel op een ssd schijf.

[xFeverr]

Dat kan niet, want een Pi draait niet op de x86-architectuur. Dus daar ga je nooit x86_64 op zien als je het commando `uname -m` uitvoert.

Maar een Pi kan inderdaad prima dat allemaal draaien, maar dan wel de arm-versies.

[mcmd]

Inderdaad, het laatste

[ralphm]

x86_64 is geen ARM, dus niet van toepassing, maar ook dit is 64-bit.

[proostyves]

Ah ok, had over ARM deel gelezen in het artikel.

[Lord Anubis]

Dan via Docker laten werken.

[naftebakje]

Je krijgt al maanden een waarschuwing bij de repairs dat 32bits ondersteuning stopt.

[Sharky]

Ik volg die opmerking over die storage driver niet helemaal. Kan ik gewoon de update uitvoeren als hij naar voren komt in HA of moet ik eerst nog iets handmatigs doen?

[elparia]

Zoals ik het lees: nieuwe installaties gebruiken straks de nieuwe storage-driver, bestaande gebruikers kunnen migreren na deze update. Denk dat het optioneel is voor nu, ik ga zelf wel direct migreren.

[AgeOfPanic]

Misschien domme vraag, maar waar kan ik dat commando uitvoeren in HomeAssistant?

[Yzord]

In je Terminal. Tenminste, daar doe ik het altijd. Staat bij mij in het linker kolom, maar kan goed zijn dat ik deze ooit zelf heb toegevoegd.

[Ortep]

Waar zit de terminal? Ik ben hem nog nooit tegengekomen

[ballo50]

De Terminal kan via een add-on geïnstalleerd worden (dus NIET via HACS), maar je kan het commando ook gewoon intypen in de command prompt op je HA host. Als deze dus op een fysieke machine draait (bijv een thinclient of Pi), dan moet je een keyboard en monitor aansluiten. Als je hem virtueel draait (via byv proxmox) dan moet je via de console interface van je hypervisor naar het (virtuele) scherm om daar de command prompt te zien.

[jvwou123]

De terminal kun je installeren via de Add-On's.

Linkje:
https://my.home-assistant.io/redirect/supervisor_addon/?addon=core_ssh

[Yzord]

Dan denk ik dat je die moet installeren via HACS

[lenwar]

Ja, je kunt gewoon updaten. Je 'moet' daarna niets doen, maar als je naar de nieuwe storage-driver wilt overstappen, dan kun je die op de aangegeven manier migreren. (en dus (uiteraard) vantevoren een backup maken enz.)

[GertMenkel]

Nieuwe installaties krijgen de nieuwe opslagmethode, oude installaties behouden de oude.

Wil je over op de nieuwe technologie (wat de genoemde voordelen met zich meebrengt) dan kun je dat commando uitvoeren in een terminal op je home assistant installatie.

Ik heb zojuist de update geïnstalleerd zonder migratie en alles werkt nog gewoon. Ga de migratie zo direct doen, maar voor zover ik kan zien is de oude opslagmethode nog gewoon ondersteund en hoef je de migratie (nog) niet uit te voeren.

Update: migratie gedaan, twee keer rebooten zoals in de instructies staat en alles werkt zoals verwacht.

[Reactie gewijzigd door GertMenkel op 19 januari 2026 15:17]

[RudolfR]

Volgens mij is het alleen standaard voor nieuwe gebruikers. Bestaande gebruikers kunnen migreren via de beschreven stappen, maar is geen vereiste.
Ik heb nu te weinig diskruimte vrij, dus ik migreer nog even niks.
(Storage 50.8 GB of 62.3 GB used)

[ocarina]

HA verandert niks aan je storage driver bij bestaande installaties, je kan dus gewoon de update uitvoeren. Enkel de default installatiemethode is gewijzigd. Je kunt wel handmatig migreren met het in het artikel genoemde commando, maar dat is alleen nodig als je de nieuwe storage driver wilt gebruiken.

[Daan S]

Een volledige backup maken en die downloaden lijkt mij een goede voorzorg voordat je deze updates uitvoert.

[lenwar]

Backups moet je sowieso direct offloaden toch? (althans. Minimaal eens in de zoveel tijd ) Je hebt niets aan je backup als je er niet (meer) bij kunt.

[Luchtbakker]

Waar kan ik eigenlijk controleren welke bit versie ik draai? Ik draai het op een Pi4.

Als ik kijk, zie ik enkel dit:

Installatiemethode
Home Assistant OS
Core
2026.1.0
Supervisor
2026.01.1
Operating System
16.3
Frontend
20260107.0

[Zorian]

Zie mijn comment. Hopelijk lukt het daarmee.

[Luchtbakker]

Thnx!

[diehardmking]

Ik wacht toch altijd heel even voordat ik een. Major release update, mijn ervaring is wel dat hier nog wel eens iets mee omvalt

[keejoz]

Behalve version bumps zie ik toch weinig vernieuwend, mis ik iets?

[RudolfR]

Support droppen voor arm 32-bit is wel een belangrijke mijlpaal. Als dat geen impact heeft op jouw setup is dat natuurlijk mooi.

[Gizz]

Waarom heb je het idee dat je iets mist? Welke vernieuwingen verwacht je die niet al in de changelog en de inleidende tekst genoemd zijn?

Dit gaat puur om Home Assistant OS, een vrij kaal OS. Daar verwacht ik zelf geen grote innovaties bij. De inhoudelijke updates van HA zitten niet in het OS maar in HA zelf: download: Home Assistant 2026.1.0

[lenwar]

Het is ook 'maar' het besturingssysteem. Daar heb je in principe helemaal niets mee te maken. Dus in bijna 100% van de gevallen zijn die het minst interessant voor de gebruikers zelf. Het 'spannendste' is nu die nieuwe storage-laag waar je naartoe kunt migreren naar een andere snapshotter.

[Magic]

Na het uitvoeren van "docker migrate-storage-driver" geeft het "docker info" commando nog steeds "overlayfs" als storage driver aan. Opnieuw uitvoeren van "docker migrate-storage-driver" geeft juist aan dat er gemigreerd wordt náár overlayfs.

Is dat een bugje in de weergave, of is er bij mij iets mis gegaan?

[holygame]

Ik heb de migratie gedaan daarna REBOOT en bij docker info staat overlayfs.

[ballo50]

Wat is je driver type?

Ik zie na de migratie het volgende:

Storage Driver: overlayfs
driver-type: io.containerd.snapshotter.v1

[Magic]

welk commando gebruik je om de driver-type te achterhalen?

[ballo50]

Is een van de uitkomsten van "docker info"

[Magic]

Apart, bij mij mist dat veld

[Jbserious]

Ik heb precies hetzelfde, eerste de upgrade gedaan naar HAOS 17 en daarna docker migrate-storage-driver, daarna een herstart van de hele machine maar bij Docker info zie ik nog steeds overlayfs, nu weet ik niet wat het zou moeten zijn.

[danieldk]

Ik had dezelfde vraag, maar heb inmiddels uitgevonden dat overlayfs betekent dat de upgrade goed gegaan is, want daarvoor was het ogenschijnlijk overlay2:

https://github.com/home-assistant/operating-system/discussions/4440#discussioncomment-15222526

[Rawmon28]

De docker image van HA support geen add-ons direct (core versie), die moest je zelf in een container draaien. is dat nog steeds zo met v17?

[Sharky]

Dit is een update voor Home Assistant OS. Die draai je dus als OS op een device of als VM. Als je een docker gebruikt is deze update niet van toepassing.

[lenwar]

Dit gaat over HAOS.

Dat is (onder water) een docker-platform. HA core, HA supervisor, HA DNS, enz en alle add-ons draaien allemaal als aparte containers op dat platform. Met die insteek zou je een container in een container draaien.

~ # ha core info
arch: aarch64
audio_input: None
audio_output: None
backups_exclude_database: false
boot: true
duplicate_log_file: false
image: ghcr.io/home-assistant/odroid-n2-homeassistant
ip_address: 172.30.32.1
machine: odroid-n2
port: 80
ssl: false
update_available: false
version: 2026.1.2
version_latest: 2026.1.2
watchdog: true
~ # docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
13015333edd5 homeassistant/aarch64-addon-nginx_proxy:3.14.0 "/init" 42 minutes ago Up 42 minutes 0.0.0.0:8123->443/tcp, [::]:8123->443/tcp addon_core_nginx_proxy
565cd97bdf85 ghcr.io/home-assistant/odroid-n2-homeassistant:2026.1.2 "/init" 54 minutes ago Up 54 minutes homeassistant
c322077b33ff ghcr.io/bertybuttface/aarch64-addon-isponsorblocktv:2.6.2 "/init" 57 minutes ago Up 57 minutes (healthy) addon_932a64e5_isponsorblocktv
8f2d5d58b022 ghcr.io/zigbee2mqtt/zigbee2mqtt-aarch64:2.7.2-1 "/sbin/tini -- /dock…" 57 minutes ago Up 57 minutes (healthy) 0.0.0.0:8485->8485/tcp, [::]:8485->8485/tcp addon_45df7312_zigbee2mqtt
993207513c3c ghcr.io/hassio-addons/appdaemon/aarch64:0.17.13 "/init" 57 minutes ago Up 57 minutes addon_a0d7b954_appdaemon
8ae740e1cc3a homeassistant/aarch64-addon-zwave_js:0.29.0 "/init" 57 minutes ago Up 57 minutes