🌈 WLED MQTT Bridge

NestJS bridge between multiple WLED controllers and MQTT. Full documentation: tobiaswaelde.github.io/wled-mqtt-bridge.

🚀 Quick start

cp config/config.example.yml config/config.yml
# edit config/config.yml
docker compose up -d

Minimal configuration:

mqtt:
  host: mqtt.example.net
  clientId: wled-mqtt-bridge
  username: mqtt-user
  password: change-me
instances:
  - id: desk
    topic: home/wled/desk
    host: 192.168.1.30
    pingInterval: 15000
    pongTimeout: 5000
    reconnectInterval: 15000
  - id: kitchen
    topic: home/wled/kitchen
    host: 192.168.1.31

mqtt.clientId may be empty; the bridge then generates a UUID for the running process.

Example command:

mosquitto_pub -h mqtt.example.net -t 'home/wled/desk/cmd' -m '{"on":true,"bri":180}'

📚 Documentation

• 🏠 Documentation home
• ⚙️ Configuration
• 📡 MQTT contract
• 🔐 Authentication
• 🐳 Docker deployment