Home Assistant Base Images
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.
Base images
We support version that are not EOL: https://alpinelinux.org/releases/
| Image | OS | Tags | latest |
|---|---|---|---|
| armhf-base | Alpine | 3.17 3.18, 3.19, 3.20 | 3.20 |
| armv7-base | Alpine | 3.17 3.18, 3.19, 3.20 | 3.20 |
| aarch64-base | Alpine | 3.17 3.18, 3.19, 3.20 | 3.20 |
| amd64-base | Alpine | 3.17 3.18, 3.19, 3.20 | 3.20 |
| i386-base | Alpine | 3.17 3.18, 3.19, 3.20 | 3.20 |
jemalloc
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.
Python images
We support the latest 3 release with the latest 3 Alpine version.
| Image | OS | Tags | latest |
|---|---|---|---|
| armhf-base-python | Alpine | 3.10, 3.11, 3.12, 3.10-alpine3.18, 3.10-alpine3.19, 3.10-alpine3.20, 3.11-alpine3.18, 3.11-alpine3.19, 3.11-alpine3.20, 3.12-alpine3.18, 3.12-alpine3.19, 3.12-alpine3.20 | 3.12-alpine3.20 |
| armv7-base-python | Alpine | 3.10, 3.11, 3.12, 3.10-alpine3.18, 3.10-alpine3.19, 3.10-alpine3.20, 3.11-alpine3.18, 3.11-alpine3.19, 3.11-alpine3.20, 3.12-alpine3.18, 3.12-alpine3.19, 3.12-alpine3.20 | 3.12-alpine3.20 |
| aarch64-base-python | Alpine | 3.10, 3.11, 3.12, 3.10-alpine3.18, 3.10-alpine3.19, 3.10-alpine3.20, 3.11-alpine3.18, 3.11-alpine3.19, 3.11-alpine3.20, 3.12-alpine3.18, 3.12-alpine3.19, 3.12-alpine3.20 | 3.12-alpine3.20 |
| amd64-base-python | Alpine | 3.10, 3.11, 3.12, 3.10-alpine3.18, 3.10-alpine3.19, 3.10-alpine3.20, 3.11-alpine3.18, 3.11-alpine3.19, 3.11-alpine3.20, 3.12-alpine3.18, 3.12-alpine3.19, 3.12-alpine3.20 | 3.12-alpine3.20 |
| i386-base-python | Alpine | 3.10, 3.11, 3.12, 3.10-alpine3.18, 3.10-alpine3.19, 3.10-alpine3.20, 3.11-alpine3.18, 3.11-alpine3.19, 3.11-alpine3.20, 3.12-alpine3.18, 3.12-alpine3.19, 3.12-alpine3.20 | 3.12-alpine3.20 |
Others
Debian images
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 | bullseye, bookworm | bookworm |
| armhf-base-debian | Debian | bullseye, bookworm | bookworm |
| aarch64-base-debian | Debian | bullseye, bookworm | bookworm |
| amd64-base-debian | Debian | bullseye, bookworm | bookworm |
| i386-base-debian | Debian | bullseye, bookworm | bookworm |
Ubuntu images
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 |
Raspbian images
| Image | OS | Tags | latest |
|---|---|---|---|
| armhf-base-raspbian | Raspbian | bullseye, bookworm | bullseye |