habridge emulates Philips Hue API to other home automation gateways such as an Amazon Echo/Dot Gen 1 (gen 2 has issues discovering ha-bridge) or other systems that support Philips Hue. The Bridge handles basic commands such as On, Off and brightness commands of the hue protocol. This bridge can control most devices that have a distinct API.
Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.
---
services:
habridge:
image: lscr.io/linuxserver/habridge:latest
container_name: habridge
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
- SEC_KEY=
volumes:
- /path/to/habridge/config:/config
ports:
- 8080:8080
- 50000:50000
restart: unless-stopped| Port | Function | Required |
|---|---|---|
| 8080:8080 | WebUI | required |
| 50000:50000 | HABridge communication port. | required |
| Variable | Function | Required |
|---|---|---|
| PUID=1000 | User ID | required |
| PGID=1000 | Group ID | required |
| TZ=Etc/UTC | Timezone | required |
| SEC_KEY= | Key used to secure communication. | required |
| Path | Function | Required |
|---|---|---|
| /config | Where HABridge stores config files and data. | required |
Pulling :latest picks the right one for your host automatically.
amd64-latestarm64v8-latest:latestStable releasesRebase to Alpine 3.20.
Revert JRE to 8 due to incomplete upstream support.
Rebase to Alpine 3.19, bump JRE to 17.
Related
2026.10.2-ls258
Home Assistant Core - Open source home automation that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Perfect to run on a Raspberry Pi or a local server