# SmartThings MQTT Bridge

SmartThings MQTT Bridge is a self-hosted, web-console-free service that exposes SmartThings device states over Message Queuing Telemetry Transport (MQTT) so MQTT-based home automation systems such as Home Assistant can. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/598/smartthings-mqtt-bridge

## Description

SmartThings MQTT Bridge is a self-hosted, web-console-free service that exposes SmartThings device states over Message Queuing Telemetry Transport (MQTT) so MQTT-based home automation systems such as Home Assistant can query and control SmartThings devices.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

24/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 2880 days ago)
- Popular: 52 (376 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/stjohnjohnson/smartthings-mqtt-bridge
- Unraid: https://ca.unraid.net/apps/smartthings-mqtt-bridge-0gxqmpg06c6fzc?q=smartthings-mqtt-bridge
- Docker Hub: https://hub.docker.com/r/stjohnjohnson/smartthings-mqtt-bridge

## Common questions

### What permission must the SmartThings PAT have for the bridge to set up?

It needs at least r:locations:* permission to read locations. Without a valid token with that permission, the bridge cannot see the home and setup fails.

### How can I inspect the MQTT topics and messages from the bridge?

Use mosquitto_sub with -h for the broker IP and -v for verbose output. Subscribe to the smartthings/# topic or # to see the traffic.

### What can cause the bridge to stop sending events to the SmartThings hub?

A configuration problem can cause this. MAC address changes on virtualized NICs have also been identified as a factor.

---
Source: Our Local Host (https://ourlocalhost.com/app/598/smartthings-mqtt-bridge), the self-hosted and open-source app directory.