Tuya is the platform behind a large share of inexpensive smart plugs, bulbs, switches, sensors and IR blasters sold under many brand names. Out of the box they are set up with the Smart Life or Tuya Smart app (or a rebranded copy) and talk to the Tuya cloud.
As the owner, you have three ways to integrate them:
| Path | How | Pros | Cons |
|---|---|---|---|
| Cloud | Official Home Assistant Tuya integration, Tuya apps, Tuya cloud API | easiest; setup by QR login with your app account | needs internet and Tuya's servers; latency; not every app function is exposed |
| Local control | TinyTuya, Tuya Local, LocalTuya with the device's local key | fast, works when the internet is down | you must obtain device ID and local key; key changes after re-pairing; device may still report to the cloud |
| Replace firmware | OpenBeken, ESPHome (via LibreTiny on Beken/Realtek chips), Tasmota on older ESP-based units | fully local, no Tuya dependency | depends on chip and firmware version; may require opening a mains device and serial flashing; you lose the Tuya app |
How to choose
- Just want it in Home Assistant quickly: official Tuya integration (cloud).
- Want it fast and resilient to internet outages, keep the device as is: local control (see the items on local keys and Home Assistant options).
- Want no vendor cloud at all: firmware replacement, if your device's chip and firmware allow it (see the firmware warning).
Privacy note
Local control speeds things up and survives internet outages, but it is not a privacy measure: Tuya Local's own documentation points out that devices keep sending status to the Tuya cloud. Only blocking the device's internet access or replacing its firmware changes that. Blocking internet access can break features and updates, so test before relying on it.
Zigbee devices
Tuya Zigbee devices normally pair with a Tuya Zigbee hub, but many also work directly with Zigbee2MQTT or ZHA, often through Tuya-specific converters or quirks (see the Zigbee item).