diyHue
diyHue emulates a Philips Hue bridge, letting you control non-Hue smart lights, bulbs, and sensors through the Hue ecosystem.
Platform availability
Available on 2 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
59/100 Fair
- Maintained
- 84last commit 29 days ago
- Popular
- 651,833 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 152 serious findings, 15 minor, OpenSSF Scorecard 1.8/10
Based on 4 of 5 factors.
Security check: 2 serious findings
- Uses @babel/traverse 7.19.3, which has a known critical vulnerability (npm)
- Uses form-data 3.0.1, which has a known critical vulnerability (npm)
Automated checks on commit 309136c, 30 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 55 days ago
- GitHub stars
- 1,833
- Open issues
- 108
- Last commit
- 2026-10-23
- Latest release
- 2022.8
- Activity
- rising
Checked 12 days ago - source: GitHub (diyhue/diyHue)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Run the automatic host installer Run the provided automatic installation command to install diyHue and set it to start on boot. This saves you from missing setup steps and makes the app start again after a reboot. source
- Use host networking in Docker For Docker, run diyHue in host network mode and map a host folder to /opt/hue-emulator/export. Host network mode helps the app reach lights without extra port setup, and the mapped folder keeps your saved data available if you need to back it up. source
- Prepare OpenWrt first If your device runs OpenWrt, first move to /tmp and install wget and ca-bundle before running the OpenWrt installer. This gives the installer the download tools and certificate files it needs to finish. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I migrate an existing diyHue installation after the project moved to the new repository?
Run the migration script from the diyHue install directory, such as /opt/hue-emulator when using the easy install script. If you run diyHue in Docker, pull the latest image instead.
My Philips TV detects the diyHue bridge but cannot connect; what should I try?
Follow the pairing instructions and temporarily disconnect your internet connection. This can make the TV perform a local network search instead of using the Philips remote API.
How do I pair diyHue with the official Philips Hue app?
Open the Hue app, search for a new bridge, select the diyHue bridge, and connect. After pairing, you can add your lights.
Can I install diyHue from Home Assistant?
Yes, you can install the official Home Assistant add-on from the store. Docker and host installation are also available options.
Does diyHue support Hue Entertainment or ambilight?
Yes, it supports the Hue Entertainment API for synchronized light shows and ambilight experiences.
Answers sourced from diyhue.org, diyhue.readthedocs.io, github.com
Community
- Latest topics - diyHue (forum)
- DIYHUE : r/smarthome - Reddit (reddit)
- DIYHue Hue Sync : r/homeassistant - Reddit (reddit)
- Diy Hue : r/Hue - Reddit (reddit)
- DIYHUE : r/homeassistant - Reddit (reddit)
- diyHue (forum)
Collected 54 days ago - public community threads