private@homelab: ~/latest
local-first guides · privacy-aware · no noisy tracking
private@homelab:~$ cat guides/article.md
· ·
7–10 minutes
read

Does Tuya/Smart Life Automation Work Without Internet?

Tuya's own developer docs define three automation tiers with different offline reliability. Here's which one your Smart Life setup actually runs on.

Does Tuya/Smart Life Automation Work Without Internet?

Search “Smart Life automation not working offline” and most results tell you to reboot your router or re-pair the device. A few go further and say flatly that Tuya/Smart Life devices have no way to run automations without phoning home to servers in China, full stop, unless you migrate everything to Home Assistant with LocalTuya.

That’s not what Tuya’s own developer documentation says. I went through it directly, and Tuya defines a three-tier automation execution model with an explicit reliability ranking covering local linkage, LAN linkage, and cloud linkage. Depending on which tier your automation falls into, it can run entirely offline inside the stock app, no Home Assistant required. The English blogs aren’t lying, exactly. They’re describing one device class (standalone Wi-Fi gear) as if it were the whole platform.

The Short Answer

It depends on whether the devices in your automation sit behind a Tuya gateway.

If your rule only involves devices paired to the same gateway (Zigbee or BLE sub-devices are the common case), it likely runs as local linkage, fully offline, with no cloud round-trip, inside the stock Smart Life or Tuya Smart app. If your rule involves a standalone Wi-Fi device with no gateway, like a plug or bulb you paired directly to Wi-Fi, it almost certainly falls back to cloud linkage and needs an active internet connection the moment the trigger fires.

That distinction, gateway-anchored versus standalone, is the part none of the consumer troubleshooting content covers.

Tuya’s Three Automation Tiers

Tuya’s documentation names the tiers 本地联动 (local linkage), 局域网联动 (LAN linkage), and 云端联动 (cloud linkage), and states the reliability order plainly. Local linkage beats LAN linkage beats cloud linkage, and Tuya recommends local linkage as the way to get dependable execution.

Local linkage is the top tier. Every device in both the condition and the action of the rule has to be a sub-device of the same gateway, or the gateway itself. When that’s true, the rule executes entirely on the gateway with no cloud dependency.

LAN linkage is the middle tier. It kicks in when the devices in a rule are split across different gateways, but those gateways are on the same home network and at least one of them runs Linux. In that case the Linux-capable gateway becomes what Tuya’s docs call the primary gateway, and it takes over execution for the whole rule, still without touching the cloud.

Cloud linkage is the fallback. It’s used whenever a rule doesn’t qualify for local or LAN execution, most commonly because a standalone Wi-Fi device with no gateway is involved, or the automation uses an action type the local and LAN tiers don’t support. Cloud linkage needs an internet connection at the exact moment the trigger fires. No connection, no automation.

Tuya’s own marketing page for its gateway hardware backs this up outside the developer docs. Its Chinese-language copy describes the same cross-gateway, cross-protocol local linkage as something that keeps executing efficiently even when the outside network connection is down. This is a currently-marketed capability of gateway-based Tuya deployments, not a legacy or theoretical feature.

What Qualifies for Local Linkage

Local linkage isn’t automatic just because you own a gateway. The rule itself has to be structured to qualify.

The eligible condition types are these.
– Tap-to-run
– Schedule
– Device-status change

The eligible action types are these.
– Device operation
– Delay
– Tap-to-run

If both the trigger and the action fall inside those categories, and every device involved is a sub-device of the same gateway, the automation runs locally. Mix in an action type outside that list, or a device from a different gateway that doesn’t meet the LAN-linkage conditions, and the rule drops to cloud linkage without any warning in the app UI.

Standalone Wi-Fi Devices Are the Exception

This is where the “requires internet” claims in English blogs come from, and for this device class they’re accurate.

A standalone Wi-Fi device, a smart plug or bulb you paired directly rather than through a gateway, doesn’t participate in the gateway-anchored local or LAN tiers at all. There’s no gateway to hand off execution to. So any multi-device automation involving that plug defaults to cloud linkage, and if your internet drops, the automation doesn’t fire until it comes back.

This is genuinely the common case for a lot of budget Tuya gear. Plugs, bulbs, and switches are frequently sold and set up as pure Wi-Fi devices with no gateway in the picture, which is exactly why the troubleshooting-listicle framing (“just check your Wi-Fi”) felt true enough to become the default answer online. It’s true for that device class. It’s not true for gateway-paired Zigbee or BLE devices, which most of the English coverage doesn’t distinguish at all.

Scheduled Timers Are a Separate Case

A single device’s own schedule (turn this plug on at 7am) is not the same thing as a multi-device linkage automation, and it behaves differently.

Per Tuya’s support documentation, local timing rules are stored both in the cloud and locally on the device itself, and the device’s own local timer determines execution independent of whether the device is currently online. There’s one caveat worth knowing: if the device loses power during a timing period, its local schedule resets to the initial setting and has to be recalibrated from the cloud the next time it reconnects. A device that stays offline after a power cut won’t resume its timers until it gets back online at least once.

That local-timer behavior is specific to single-device scheduling. It shouldn’t be read as evidence that multi-device linkage automations also survive offline by default. They don’t, unless they qualify for local or LAN linkage as described above.

How to Check Whether Your Automations Are Actually Running Locally

Tuya’s app doesn’t surface a “this automation is local” badge anywhere I could find in the documentation, which is itself part of the problem. The practical way to check is behavioral. Disconnect the relevant gateway or router from the internet (leaving the local network intact) and trigger the automation manually. If it still fires, it’s running as local or LAN linkage. If it doesn’t, it’s cloud-dependent.

A faster proxy, without the disconnect test, is to look at whether every device in the rule is paired to the same gateway (check each device’s “added via” info in the app) and whether the condition and action types match the eligible list above. If both check out, you’re very likely on local linkage already, with zero extra setup.

If You Want Guaranteed Local Control

For gateway-paired Zigbee or BLE devices, the stock app’s local linkage already gets you real offline execution, no Home Assistant needed. If your devices are standalone Wi-Fi, though, the stock app has no equivalent local path. That’s the actual gap that LocalTuya-style setups inside Home Assistant fill, pulling a device’s local key so Home Assistant can control it directly over your LAN, bypassing Tuya’s cloud for both control and automation regardless of whether a gateway is involved. Tuya Zigbee devices are the easier case here, since they don’t need a per-device local key at all once they’re on your own coordinator; Wi-Fi devices are the ones that do.

Which path makes sense depends on what you’re trying to solve. If you just want reliable automations and you’re already buying gateway-paired devices, you likely don’t need to change anything. If you specifically want to eliminate Tuya’s cloud from the picture entirely, including for standalone Wi-Fi gear, that’s a different, more involved project, and one worth weighing against what the Tuya app and cloud actually collect in the first place.

The bigger issue here isn’t the technical limitation on standalone Wi-Fi devices, it’s that Tuya buries this distinction in developer-facing docs instead of explaining it anywhere a Smart Life app user would actually see it. The capability is real and currently marketed to hardware partners. It’s just invisible to the person deciding whether to trust their automations.

The same local-versus-cloud split shows up on the Xiaomi/Mi Home side of this market too, with its own gateway-tier rules. If you’re setting up a broader local-first network for either ecosystem, the VLAN groundwork is the same regardless of vendor.

FAQ

Does Smart Life work without the internet?
Partially. Devices paired to the same Tuya gateway can run automations offline via local or LAN linkage. Standalone Wi-Fi devices generally can’t, and fall back to cloud linkage, which needs an internet connection to fire.

What is local linkage in Tuya?
Tuya’s top-tier automation execution mode. Every device in the rule’s condition and action must be a sub-device of the same gateway. When that’s true, the rule runs entirely on the gateway with no cloud dependency.

Why did my Tuya automation stop working when the Wi-Fi went down?
Most likely because it involves a standalone Wi-Fi device with no gateway, which defaults to cloud linkage, or the rule uses an action type outside the local/LAN eligible list and silently falls back to cloud execution.

Do I need a gateway for Tuya devices to work offline?
For multi-device automations, yes, in practice. Devices without a shared gateway don’t qualify for local or LAN linkage and depend on Tuya’s cloud to run rules involving them.

Is Tuya Smart different from Smart Life for offline automations?
No. Both apps sit on the same Tuya platform and execution architecture. The local/LAN/cloud linkage tiers apply the same way regardless of which app you use.

Whether Tuya ever surfaces this tiering directly in the consumer app, instead of leaving it in developer documentation, is worth watching. Until then, checking each device’s pairing type is the only reliable way to know what you’re actually running on.

local-firstHome Assistantno-cloud