zackwag/pesetech2mqtt repository overview

⁠pesetech2mqtt

A lightweight Python bridge that connects Pesetech/Lepu artificial skylights over Bluetooth Mesh to Home Assistant⁠ via MQTT Discovery.

Source & full docs: https://github.com/zackwag/pesetech2mqtt⁠

⁠Tags

Images are multi-arch: linux/amd64 and linux/arm64.

⁠Quick start

⁠Prerequisites

1. Provision your skylights using the Telink SIG Mesh app (Android/iOS).
2. Export the mesh configuration from the app — this is your pesetech_mesh.json.

⁠docker run

docker run -d --name pesetech2mqtt --restart unless-stopped \
  --network host \
  --privileged \
  -v "$PWD/data:/data" \
  -v "$PWD/pesetech_mesh.json:/data/pesetech_mesh.json:ro" \
  -e MQTT_HOST=192.168.1.x \
  zackwag/pesetech2mqtt:latest

⁠docker-compose.yml

services:
  pesetech2mqtt:
    image: zackwag/pesetech2mqtt:latest
    restart: unless-stopped
    network_mode: host
    privileged: true
    environment:
      MQTT_HOST: 192.168.1.x
    volumes:
      - ./data:/data
      - ./pesetech_mesh.json:/data/pesetech_mesh.json:ro

⁠Configuration

When using the provided docker-compose.yml, two additional variables control host-side mount locations (set in .env; not passed into the container):

On first start the gateway imports all skylights from the mesh export and writes config.yaml and store.yaml to /data. Later starts reuse the saved configuration — the mesh export is only needed for the initial import.

⁠Notes

• --network host and --privileged are required — bluetooth-meshd opens raw L2CAP sockets and needs direct access to the host Bluetooth adapter.
• Off-with-transition is unreliable on these lights. Use a brightness/color transition first, then turn off separately.