diyHue

diyHue emulates a Philips Hue bridge, letting you control non-Hue smart lights, bulbs, and sensors through the Hue ecosystem.

  • Home Automation
  • Tools & Utilities
diyHue emulates a Philips Hue bridge, letting you control non-Hue smart lights, bulbs, and sensors through the Hue ecosystem. It lets homelabbers and smart home users drive a mixed device collection, including DIY and third-party hardware, from Hue-compatible apps and platforms without a physical Hue Bridge.

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.

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

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

Collected 54 days ago - public community threads