Device Integrations

Smart Lighting, Switches and Buttons for Home Assistant: Kasa, Govee, Zigbee and Thread

Set up TP-Link Kasa, Govee lights, Zigbee switches and Thread devices in Home Assistant, and pick buttons that work well with your automations.

On this page
  1. Choosing a lighting system
  2. TP-Link Kasa
  3. Govee lights
  4. Zigbee battery switches
  5. Buttons for automations
  6. Thread: what it is and what it isn’t
  7. Matterbridge: exposing Home Assistant to other ecosystems
  8. Safety

Lighting is where many people start with Home Assistant. This guide covers the integrations for Kasa, Govee and Zigbee switches, how to choose buttons for automations, and what Thread and Matterbridge do (and what they don’t).

Choosing a lighting system

Start with your wiring, not the brand. Many in-wall smart switches need a neutral wire, and some don’t. Check the switch box before you buy.

Lutron Caséta is a common choice for retrofitting existing homes. Its switches work with Home Assistant through a Caséta bridge. For color and tunable white bulbs, Philips Hue is a popular option. See Philips Hue in Home Assistant for setup.

Smart bulbs need power to stay reachable. If the wall switch is off, the bulbs lose power and show as unavailable in Home Assistant. Keep the wall switch on and control the bulbs from automations, or use a smart switch in detached or smart-bulb mode so the bulbs stay powered.

Kasa devices use the core TP-Link Smart Home integration. It runs locally and usually finds devices automatically.

  1. Set up the device in the Kasa app, on the same network as Home Assistant.
  2. If your firmware requires it, turn on Third-Party Compatibility in the Kasa app.
  3. In Home Assistant, go to Settings > Devices & services > Add integration, search for TP-Link Smart Home, and let it find your devices. If one doesn’t appear, enter its IP address.
  4. Enter your TP-Link credentials when asked.

Newer Kasa and Tapo firmware uses encrypted authentication. Home Assistant asks for TP-Link account credentials during setup, but control still happens on your local network. Recent releases support many Tapo devices, though support varies by model. For Tapo cameras, see TP-Link Tapo cameras in Home Assistant. Reserve a static IP address for each device in your router so they stay reachable after reboots.

Govee lights

The built-in Govee lights local integration controls supported Govee lights over your local network. Not every Govee model supports it.

  1. In the Govee Home app, open each light’s settings and turn on LAN Control.
  2. In Home Assistant, go to Settings > Devices & services > Add integration and select Govee lights local.

If a light has no LAN Control option, it probably doesn’t support local control. For those lights, consider a Bluetooth integration, which needs Bluetooth in range or an ESPHome Bluetooth proxy.

Many users run govee2mqtt instead, a community bridge that uses MQTT. It combines local LAN control with cloud features such as scenes and segments, and people often use it when the built-in integration struggles to find devices.

Zigbee battery switches

Third Reality’s Smart Switch Gen3 is a battery-powered Zigbee actuator. It snaps over an existing toggle or rocker switch, so you don’t need to rewire anything or have a neutral wire. It runs on AAA batteries and needs a Zigbee hub. Home Assistant works as that hub through ZHA or Zigbee2MQTT.

Not every “smart switch” works this way. Some replace the switch and need wiring. Others are battery covers that flip the existing toggle. Read the spec for the exact model before you buy.

One caveat: with more than one switch in the same box, automating one leaves the other manual. Its position may not match the light’s real on/off state.

Buttons for automations

Buttons are a good way to trigger automations without a phone. Home Assistant reports presses as device triggers or event entities, with types such as single, double and long press. Models that work well include:

  • IKEA RODRET, STYRBAR and SOMRIG (Zigbee)
  • Aqara Mini Switch (Zigbee)
  • Philips Hue Dimmer and Hue Smart Button (Zigbee)
  • Zooz ZEN32 (Z-Wave)
  • Lutron Pico, which needs a Caséta bridge
  • Shelly BLU Button (Bluetooth)

Pick a button that uses the same protocol as your hub. A Zigbee button needs a Zigbee coordinator, a Z-Wave button needs a Z-Wave stick, and a Bluetooth button needs a Bluetooth adapter or proxy.

Thread: what it is and what it isn’t

Thread is a low-power IPv6 mesh network on the 2.4 GHz band. It uses the same radio standard as Zigbee, but the two protocols don’t interoperate. Thread only carries data. Matter, or Apple’s HomeKit, runs on top of it.

A Thread device needs a border router to reach your home network. Common border routers include:

  • The OpenThread Border Router add-on in Home Assistant, with a compatible radio such as the Connect ZBT-1
  • Apple TV 4K (Thread-capable models; the Wi-Fi-only 64 GB model and the first generation lack Thread) and HomePod mini
  • Second-generation Nest Hub and Nest Wifi Pro

Check that your home has at least one border router before you buy Thread devices.

Matterbridge: exposing Home Assistant to other ecosystems

Matterbridge is a third-party Node.js tool. It takes devices that aren’t Matter, such as Zigbee or Z-Wave devices already in Home Assistant, and exposes them to Matter controllers like Apple Home, Google Home or Alexa. It is not a Matter controller, and you don’t need it to add a Matter device to Home Assistant.

The matterbridge-hass plugin’s documentation gives these cautions:

  • Don’t pair an exposed device back into Home Assistant. That creates duplicates.
  • Use labels or areas to choose which devices are exposed, so you don’t share everything.
  • Apple Home can crash if a robot vacuum sits on the same bridge, so use server mode for that device.

Home-Assistant-Matter-Hub is an alternative that some users find simpler to set up.

If you’re choosing a Zigbee integration for these switches and bulbs, read ZHA vs Zigbee2MQTT. For the general model of integrations and devices, see adding and managing devices in Home Assistant.

Safety

  • Turn off the breaker, and confirm the wires are dead, before you install an in-wall switch.
  • Many in-wall smart switches need a neutral wire, and some don’t, so check before you buy.

The complete guide to device integrations

Adding and Managing Devices in Home Assistant: Integrations and Device Classes
Read the guide

Keep exploring

Guides from other topics

All topics →