These base images are designed as Docker base images for use with building Home Assistant containers and add-ons. It is recommended to use these as a base for your own Home Assistant Add-ons.
Using these images as a base for other Docker projects is, however, not recommended.
The image include S6-Overlay, Bashio and TempIO.
We support version that are not EOL: https://alpinelinux.org/releases/
| Image | OS | Tags | latest |
|---|---|---|---|
| armhf-base | Alpine | 3.19, 3.20, 3.21, 3.22 | 3.22 |
| armv7-base | Alpine | 3.19, 3.20, 3.21, 3.22 | 3.22 |
| aarch64-base | Alpine | 3.19, 3.20, 3.21, 3.22 | 3.22 |
| amd64-base | Alpine | 3.19, 3.20, 3.21, 3.22 | 3.22 |
| i386-base | Alpine | 3.19, 3.20, 3.21, 3.22 | 3.22 |
We support on our platforms jemalloc. On the application which you want to enable it, set as environment LD_PRELOAD="/usr/local/lib/libjemalloc.so.2" on your Dockerfile or before you start the application.
We support the latest 3 release with the latest 3 Alpine version.
Note
Python 3.14 is build from the release candidate. It's only recommended for wheel builds at the moment.
Furthermore, 3.14 will only be available on aarch64 and amd64 following the deprecation of armhf, armv7 and i386.
See https://www.home-assistant.io/blog/2025/05/22/deprecating-core-and-supervised-installation-methods-and-32-bit-systems/
| Image | OS | Python versions | Tags | latest |
|---|---|---|---|---|
| armhf-base-python | Alpine | 3.12, 3.13 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22 | 3.13-alpine3.22 |
| armv7-base-python | Alpine | 3.12, 3.13 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22 | 3.13-alpine3.22 |
| aarch64-base-python | Alpine | 3.12, 3.13, 3.14 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22, 3.14-alpine3.20, 3.14-alpine3.21, 3.14-alpine3.22 | 3.13-alpine3.22 |
| amd64-base-python | Alpine | 3.12, 3.13, 3.14 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22, 3.14-alpine3.20, 3.14-alpine3.21, 3.14-alpine3.22 | 3.13-alpine3.22 |
| i386-base-python | Alpine | 3.12, 3.13 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22 | 3.13-alpine3.22 |
Note: We prefer the Alpine based version because it's more IoT friendly. In some case, you need a glibc system like this.
| Image | OS | Tags | latest |
|---|---|---|---|
| armv7-base-debian | Debian | bookworm, trixie | trixie |
| armhf-base-debian | Debian | bookworm, trixie | trixie |
| aarch64-base-debian | Debian | bookworm, trixie | trixie |
| amd64-base-debian | Debian | bookworm, trixie | trixie |
| i386-base-debian | Debian | bookworm, trixie | trixie |
Note: We prefer the alpine based version because it's more IoT friendly. In some case, you need a glibc system like this.
| Image | OS | Tags | latest |
|---|---|---|---|
| armv7-base-ubuntu | Ubuntu | 14.04, 16.04, 18.04 20.04 | 20.04 |
| aarch64-base-ubuntu | Ubuntu | 14.04, 16.04, 18.04 20.04 | 20.04 |
| amd64-base-ubuntu | Ubuntu | 14.04, 16.04, 18.04 20.04 | 20.04 |
| i386-base-ubuntu | Ubuntu | 14.04, 16.04, 18.04 |
| Image | OS | Tags | latest |
|---|---|---|---|
| armhf-base-raspbian | Raspbian | bookworm | bookworm |