# ESPHome-LibreTiny

ESPHome-LibreTiny is the official LibreTiny fork of ESPHome that adds native support for the BK7231 and RTL8710B chipsets, letting you use Tuya-based hardware with ESPHome. It is open source and self-hosted, installable on TrueNAS and Unraid.

Canonical page: https://ourlocalhost.com/app/2794/esphome-libretiny

## Description

ESPHome-LibreTiny is the official LibreTiny fork of ESPHome that adds native support for the BK7231 and RTL8710B chipsets, letting you use Tuya-based hardware with ESPHome. It provides ready-made container builds so you no longer need to compile the container yourself, making it a convenient choice for homelabbers integrating these chips into Home Assistant.

## Platform availability

Available on 2 of 10 platforms: Unraid, TrueNAS.

## Health score

68/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 7 days ago)
- Popular: 82 (12,105 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 20 (1 serious finding, 2 minor, CI, tests, OpenSSF Scorecard 6.6/10)

## Security check

1 serious finding: A GitHub workflow can be triggered by outsiders to run their code with the project's secrets.
Automated checks on commit 45ea5f4, 15 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/esphome/esphome
- TrueNAS: https://apps.truenas.com/catalog/esphome
- Unraid: https://ca.unraid.net/apps/esphome-libretiny-1mkpsez1vwz3lr?q=ESPHome-LibreTiny
- Official website: https://docs.libretiny.eu/
- Documentation: https://docs.libretiny.eu/

## Common questions

### How do I migrate from the LibreTiny ESPHome add-on to the ESPHome add-on?

Move the config directory, check that the devices are present, and reboot Home Assistant.

### Where do I find instructions for entering download mode on BK72xx or RTL8710BN/BX chips?

The LibreTiny docs include a flashing/dumping guide with download-mode instructions for Beken BK72xx and Realtek RTL8710BN/BX.

### What connection details does an ESPHome API client need to connect to a device?

Use the device IP or .local name, the ESPHome API port 6053, and the noise_psk encryption key.

### Why might the Home Assistant add-on list LibreTiny devices as new instead of online after an update?

In the 2023.9.0 thread, devices were listed as new instead of online until the add-on was updated to 2023.9.

## Alternatives

- Blynk IoT: Blynk is a simple and powerful no-code application builder where you can prototype, deploy, and manage connected electronic devices at any…
- RemoteXY: RemoteXY is easy way to make and use a mobile graphical user interface for controller boards.
- Tasmota: Alternative firmware for ESP8266 with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and enti…
- esphome: ESPHome is the official container for creating custom firmware for ESP8266, ESP32, Raspberry Pi, and Beken boards.

---
Source: Our Local Host (https://ourlocalhost.com/app/2794/esphome-libretiny), the self-hosted and open-source app directory.
