home-assistant / docker-base

Home Assistant base images

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