Uploaded September 2026 | Updated November 2026, 1 day ago
How to Set Up Tuya-Local in Home Assistant
Integrating Tuya devices into Home Assistant via the standard Tuya Cloud has significant drawbacks.
Data polling is restricted, and if your internet goes down, your smart home offline devices fail to connect. Migrating to Tuya-Local solves this by connecting your devices directly to your Home Assistant server over your local network.
Here is the complete guide to installing and configuring Tuya-Local.
Prerequisites
You need the Home Assistant Community Store (HACS) and the Tuya-Local integration.
00:30 Step 1: Install HACS
If HACS is not available in your integrations menu, install it via the terminal.
Open the Home Assistant terminal and log in as Root.
Navigate to your Home Assistant configuration directory:
cd /home/admin/homeassistant/config
(Modify the path if your specific folder name differs).
Run the installation script:
curl -sfSL https://get.hacs.xyz | tr -d '\r' | bash
Restart Home Assistant to load HACS.
Navigate to Devices & Services - Add Integration.
Search for HACS and click it.
Copy the activation code provided and click the authorization link.
Log in to your GitHub account (or create one) and enter the code to connect HACS.
01:11 Step 2: Install Tuya-Local
Tuya-Local may not appear in the default HACS list, requiring a manual repository addition.
Open github.com/make-all/tuya-local in your web browser.
Click the Open HACS REPOSITORY ON link/button.
Enter your Home Assistant server IP address when prompted.
Select Add and then Download.
Reboot Home Assistant to apply the changes.
02:08 Step 3: Configure Tuya-Local
Go to Devices & Services - Add Integration.
Search for Tuya Local and click it.
Select SmartLife if you want to add all your Tuya devices to Home Assistant.
Enter your Tuya or SmartLife User code (found in the mobile app under Account and Security).
02:55 Link Tuya App to Tuya Local
Scan the displayed QR code using the Tuya app.
Once the process completes, you can add your Tuya devices using Tuya-Local. All Tuya devices must be able to connect to your Local Area Network (LAN).
Tuya Cloud vs. Tuya-Local
Switching to local control offers immediate advantages:
No Cloud Limitations: Tuya-Local operates entirely within your network, eliminating cloud-imposed data restrictions.
Offline Reliability: Devices remain responsive even when your internet connection is disrupted.
Enhanced Data: Access more detailed device data, such as precise voltage metrics.
Custom Entities: Enable hidden or disabled entities that the standard cloud integration blocks.
Custom Polling: Restrict or adjust data update intervals directly from Home Assistant.
obengplus.com/artikel/articles/430/1/Tuya-Local-untuk-Smart-Home.html
How to Set Up Tuya-Local in Home Assistant
Integrating Tuya devices into Home Assistant via the standard Tuya Cloud has significant drawbacks.
Data polling is restricted, and if your internet goes down, your smart home offline devices fail to connect. Migrating to Tuya-Local solves this by connecting your devices directly to your Home Assistant server over your local network.
Here is the complete guide to installing and configuring Tuya-Local.
Prerequisites
You need the Home Assistant Community Store (HACS) and the Tuya-Local integration.
00:30 Step 1: Install HACS
If HACS is not available in your integrations menu, install it via the terminal.
Open the Home Assistant terminal and log in as Root.
Navigate to your Home Assistant configuration directory:
cd /home/admin/homeassistant/config
(Modify the path if your specific folder name differs).
Run the installation script:
curl -sfSL https://get.hacs.xyz | tr -d '\r' | bash
Restart Home Assistant to load HACS.
Navigate to Devices & Services - Add Integration.
Search for HACS and click it.
Copy the activation code provided and click the authorization link.
Log in to your GitHub account (or create one) and enter the code to connect HACS.
01:11 Step 2: Install Tuya-Local
Tuya-Local may not appear in the default HACS list, requiring a manual repository addition.
Open github.com/make-all/tuya-local in your web browser.
Click the Open HACS REPOSITORY ON link/button.
Enter your Home Assistant server IP address when prompted.
Select Add and then Download.
Reboot Home Assistant to apply the changes.
02:08 Step 3: Configure Tuya-Local
Go to Devices & Services - Add Integration.
Search for Tuya Local and click it.
Select SmartLife if you want to add all your Tuya devices to Home Assistant.
Enter your Tuya or SmartLife User code (found in the mobile app under Account and Security).
02:55 Link Tuya App to Tuya Local
Scan the displayed QR code using the Tuya app.
Once the process completes, you can add your Tuya devices using Tuya-Local. All Tuya devices must be able to connect to your Local Area Network (LAN).
Tuya Cloud vs. Tuya-Local
Switching to local control offers immediate advantages:
No Cloud Limitations: Tuya-Local operates entirely within your network, eliminating cloud-imposed data restrictions.
Offline Reliability: Devices remain responsive even when your internet connection is disrupted.
Enhanced Data: Access more detailed device data, such as precise voltage metrics.
Custom Entities: Enable hidden or disabled entities that the standard cloud integration blocks.
Custom Polling: Restrict or adjust data update intervals directly from Home Assistant.
obengplus.com/artikel/articles/430/1/Tuya-Local-untuk-Smart-Home.html










