github homebridge/docker-homebridge alpha-2026-11-21
ALPHA: Homebridge Docker Release alpha-2026-11-21

pre-release45 minutes ago

Homebridge Docker Image

This Ubuntu Linux-based Docker image allows you to run Homebridge, developed by Nfarina, on your home network. Homebridge emulates the iOS HomeKit API, allowing you to integrate smart home devices with Apple Home.

The image supports multiple CPU architectures. Docker automatically pulls a compatible image for your system when one is available.

Ubuntu 26.04 rollout and 32-bit ARM: During fall 2026, every Homebridge Docker image except synology moves to Ubuntu 26.04, one release stream at a time. Node.js no longer publishes 32-bit builds, so images based on Ubuntu 26.04 no longer include the arm32v7 (32-bit ARM) architecture. If you run Homebridge in Docker on a 32-bit ARM device, move to a 64-bit (arm64v8) OS to keep receiving updates. Images already published stay available under their dated tags (for example 2026-10-23).

Image Tag Architectures Release Type
latest, ubuntu amd64, arm32v7*, arm64v8 Stable
synology amd64, arm32v7, arm64v8 Stable
beta amd64, arm64v8 Beta
alpha amd64, arm64v8 Alpha
legacy amd64, arm32v7*, arm64v8 Legacy

* arm32v7 is dropped when that release stream moves to Ubuntu 26.04. synology stays on Ubuntu 22.04 and is not part of this rollout.

Release Types

  • Stable (latest, ubuntu): Stable releases using the latest stable versions of Homebridge and its plugins.
  • Legacy (legacy): Stable releases using Homebridge 1.x and compatible plugin versions.
  • Beta (beta): Pre-release versions of Homebridge and the Homebridge UI for testing upcoming features.
  • Alpha (alpha): Early pre-release versions of Homebridge and the Homebridge UI for development and early testing.

Pre-release Changes (not yet in stable)

Built from branch alpha-2026.11.21.

  • chore(lint): also silence the unreachable-function note of the older shellcheck on CI runners (e78f65a)
  • perf(image): remove vim and logrotate from the image (9cd72c2)
  • test(non-root): start the image as a non-root user and check processes, files and rights (71e0069)
  • docs(non-root): say plainly what the non-root mode is for and what it is not (df8324a)
  • fix(non-root): give the homebridge user the same uid and gid in every image (2e89042)
  • perf(non-root): change file owners only where they are wrong, not on every start (3445a92)
  • fix(non-root): give Homebridge the network rights it has on an apt install (e4d3971)
  • fix(non-root): use an existing group for PGID instead of refusing it (6932e2b)
  • ci: run lint, the script tests and the container tests on every pull request (34e5bd9)
  • chore(lint): clear the shellcheck and hadolint notes and add test/lint.sh (6826ef8)
  • fix(setup): check DSM_HOSTNAME before use and make the volume folder before writing into it (26a06e9)
  • refactor(s6): use dependencies.d folders, wait for avahi and follow the log with tail -F (e6c24af)
  • ci: pass workflow values to shell steps through env and match release tags strictly in clean-up (bdfad75)
  • chore: remove unused lines, a Dependabot rule that can not work and trim the build context (6455b8c)
  • fix(build): stop adding a second source-docker.sh block to source.sh (a8f6707)
  • docs: bring the README and the Copilot instructions in line with the code (d11b9d2)
  • refactor(scripts): replace the five local build scripts with build-local.sh (6e234c3)
  • fix(scripts): make purge-docker.sh remove only Homebridge images and ask first (6c446f9)
  • fix(installer): read the time zone on Debian 13, keep an old Compose file, wait 10 min at most (7828c94)
  • ci: warn when a pre-release branch is missing changes that are on latest (51cf605)
  • fix(release): list only the stream's own changes in the release notes (f0546e1)
  • fix: make sudo hb-service start, stop and restart work in the container through s6 (14a3d76)
  • fix: put system folders before node_modules/.bin on the PATH of the root start scripts (b93a88b)
  • perf(image): install only the named packages and drop the desktop tool avahi-discover (227927f)
  • fix(setup): report jq, npm and startup script errors and never install homebridge@latest (d77ac5a)
  • fix(setup): keep the user's own .npmrc lines and drop two old npm settings (922dcd3)
  • fix(setup): remove the old UI entry from package.json with one checked jq write (6ce9e04)
  • fix: remove tzupdate and set the time zone by replacing the /etc/localtime link (2edc17a)
  • ci: give each workflow job only the rights it needs and pin outside actions by commit (39e9d3d)
  • ci: test the image on amd64 and arm64 before it is copied to the public tags (cb5742c)
  • fix(build): check s6-overlay by checksum and install homebridge from the signed apt repo (7635d5e)
  • feat: stop the container when start-up fails and add a HEALTHCHECK to the image (3e4447e)
  • fix: tell two images built on the same day apart and refuse an unasked second build (b898095)
  • fix(ci): fail Stage 1 when the triggered Stage 2 run fails, times out or is not found (2be3eb2)
  • fix(setup): stop with a clear error when data is found at /var/lib/homebridge (4476d45)
  • fix(setup): keep a newer Homebridge in the volume unless the release stream changed (2caf2f5)
  • fix(setup): repair a broken package.json from a backup and the installed plugins (afd3ba0)
  • feat: optionally run the homebridge service as a non-root user (#1123) (0b2047a)

Current Package Manifest:

Docker.manifest

Homebridge Docker Package Manifest

Release Version: alpha-2026-11-21

Package Version
Ubuntu ubuntu:26.04
ffmpeg for homebridge v2.2.2
Homebridge APT Package v2.0.27-alpha.20261119
NodeJS 26.13.1
Homebridge UI 6.0.1-alpha.26
Homebridge 2.5.1-beta.5

Changes Since Previous Release (alpha-2026-11-20):

No meaningful changes detected in Docker.manifest.

Docker Homebridge Changes

  • perf(image): remove vim and logrotate from the image (9cd72c2)
  • fix(non-root): give the homebridge user the same uid and gid in every image (2e89042)
  • perf(non-root): change file owners only where they are wrong, not on every start (3445a92)
  • fix(non-root): give Homebridge the network rights it has on an apt install (e4d3971)
  • fix(non-root): use an existing group for PGID instead of refusing it (6932e2b)
  • chore(lint): clear the shellcheck and hadolint notes and add test/lint.sh (6826ef8)
  • fix(setup): check DSM_HOSTNAME before use and make the volume folder before writing into it (26a06e9)
  • refactor(s6): use dependencies.d folders, wait for avahi and follow the log with tail -F (e6c24af)
  • chore: remove unused lines, a Dependabot rule that can not work and trim the build context (6455b8c)
  • fix(build): stop adding a second source-docker.sh block to source.sh (a8f6707)
  • fix: make sudo hb-service start, stop and restart work in the container through s6 (14a3d76)
  • fix: put system folders before node_modules/.bin on the PATH of the root start scripts (b93a88b)
  • perf(image): install only the named packages and drop the desktop tool avahi-discover (227927f)
  • fix(setup): report jq, npm and startup script errors and never install homebridge@latest (d77ac5a)
  • fix(setup): keep the user's own .npmrc lines and drop two old npm settings (922dcd3)
  • fix(setup): remove the old UI entry from package.json with one checked jq write (6ce9e04)
  • fix: remove tzupdate and set the time zone by replacing the /etc/localtime link (2edc17a)
  • fix(build): check s6-overlay by checksum and install homebridge from the signed apt repo (7635d5e)
  • feat: stop the container when start-up fails and add a HEALTHCHECK to the image (3e4447e)
  • fix: tell two images built on the same day apart and refuse an unasked second build (b898095)
  • fix(setup): stop with a clear error when data is found at /var/lib/homebridge (4476d45)
  • fix(setup): keep a newer Homebridge in the volume unless the release stream changed (2caf2f5)
  • fix(setup): repair a broken package.json from a backup and the installed plugins (afd3ba0)
  • feat: optionally run the homebridge service as a non-root user (#1123) (0b2047a)

Don't miss a new docker-homebridge release

NewReleases is sending notifications on new releases.