Quick Answer
Via Hue Bridge: Easiest, fully local, keeps Hue app working. Add the Hue integration in HA, press the bridge button, done. Via Zigbee2MQTT: No bridge needed, more attributes exposed, but Hue bulbs leave your Hue ecosystem. Choose the bridge approach unless you're replacing the Hue hub entirely.
Table of Contents
What You Need
- Philips Hue Bridge v2 (square) — for bridge approach
- OR Sonoff ZBDongle-P — for Zigbee2MQTT approach
- Philips Hue bulbs
- Home Assistant instance
Two Approaches
Hue bulbs are Zigbee devices at their core. You can control them two ways:
- Via Hue Bridge: Keep using the Hue Bridge as the Zigbee coordinator for your bulbs. HA connects to the bridge via its local REST API (no cloud). You keep the Hue app, Hue scenes, and Hue-native features.
- Via Zigbee2MQTT (no bridge): Pair Hue bulbs directly to your Zigbee2MQTT coordinator. The Hue Bridge is no longer involved. You lose Hue app control and Hue scenes, but gain direct device control and more attributes.
The Right Choice for Most People
Keep your Hue Bridge. The HA-Hue bridge integration is excellent — fully local, reliable, and preserves your existing Hue setup. Only abandon the bridge if you want to consolidate everything onto one Zigbee coordinator.
Hue Bridge Setup in HA
- Ensure your Hue Bridge is powered on and on the same network as HA
- HA usually auto-discovers the bridge — check Settings → Integrations for a "Philips Hue" banner
- Click Configure → press the round button on top of the Hue Bridge within 30 seconds
- HA links to the bridge — all lights, groups, and scenes appear as entities
HA communicates with the bridge via its local REST API (port 80/443). No Philips cloud servers are involved once set up.
Entities you'll get:
light.living_room_1,light.living_room_2— individual bulbslight.living_room— Hue room group (controls all bulbs together)scene.living_room_relax— your saved Hue scenes- Motion sensors, dimmer switches, and other Hue accessories
Zigbee2MQTT Approach (No Bridge)
To pair Hue bulbs directly with Zigbee2MQTT:
- Factory reset each Hue bulb (turn on/off 5 times quickly, or use the Hue app's "reset" option)
- Enable Permit Join in Zigbee2MQTT
- Put the bulb near your coordinator — it should pair automatically
- Rename it in Z2M and it appears in HA
Presence-Based Lighting (YAML)
automation:
- alias: "Living room adaptive lighting"
description: "Adjust Hue lights based on time and presence"
trigger:
- platform: state
entity_id: binary_sensor.living_room_motion
to: "on"
action:
- choose:
- conditions:
- condition: time
after: "07:00:00"
before: "12:00:00"
sequence:
- service: light.turn_on
target:
entity_id: light.living_room
data:
brightness_pct: 100
color_temp: 6500
- conditions:
- condition: time
after: "12:00:00"
before: "18:00:00"
sequence:
- service: light.turn_on
target:
entity_id: light.living_room
data:
brightness_pct: 80
color_temp: 4000
- conditions:
- condition: time
after: "18:00:00"
before: "23:00:00"
sequence:
- service: light.turn_on
target:
entity_id: light.living_room
data:
brightness_pct: 40
color_temp: 2700
Group Control
Use HA's light groups to control multiple Hue lights together, regardless of whether they're on the bridge or Zigbee2MQTT:
light:
- platform: group
name: "Living Room All"
entities:
- light.sofa_lamp
- light.ceiling_1
- light.ceiling_2
- light.floor_lamp
Troubleshooting
- Entities don’t appear in Home Assistant: Confirm the integration is loaded correctly and double-check that the device is supported by the platform you chose.
- Commands feel delayed: This is usually caused by cloud polling, weak Wi-Fi, or a slow Zigbee mesh rather than Home Assistant itself.
- Things work in the vendor app but not in HA: Re-check credentials, local API permissions, and whether the device is using the correct network path.
- Automations misfire: Open the automation trace in Home Assistant and verify the exact entity IDs and state changes being used.
FAQ
Does HA's Hue integration need the Hue cloud?
No — HA uses the Hue Bridge's local REST API. The bridge itself may phone home to Philips for firmware updates, but HA-Hue communication is 100% local.
Can I use Hue dimmer switches in Home Assistant automations?
Yes — Hue dimmer switches appear as devices in HA (via the Hue bridge integration) and expose button events. You can use them as automation triggers for anything in HA, not just Hue lights.
Do Hue scenes work in Home Assistant?
Yes — if using the bridge integration, your Hue scenes appear as HA scene entities and can be activated in automations with the scene.turn_on service.
SmartWired uses affiliate links. If you buy through our links, we may earn a commission at no extra cost to you. See our Affiliate Disclosure.