ring-mqtt

ring-mqtt

Docker app from digiblur's Repository

Interact with Ring Inc products (cameras/alarms/smart lighting) via MQTT - See the project page for token auth procedure - https://github.com/tsightler/ring-mqtt#authentication

Overview
Interact with Ring Inc products (cameras/alarms/smart lighting) via MQTT - See the project page for token auth procedure - https://github.com/tsightler/ring-mqtt#authentication

ring-mqtt-logo

About

Ring LLC sells security related products such as video doorbells, security cameras, alarm systems and smart lighting devices. The ring-mqtt project uses the Ring API (the same one used by Ring official apps) to act as a bridge between these devices and an local MQTT broker, thus allowing any automation tools that can leverage the open standards based MQTT protocol to effectively integrate with these devices. The project also supports video streaming by providing an RTSP gateway service that allows any media client supporting the RTSP protocol to connect to a Ring camera livestream or to play back recorded events (Ring Protect subscription required for event recording playback). Please review the full list of supported devices and features for more information on current capabilities.

Installation and Configuration

Please refer to the ring-mqtt project wiki for complete documentation on the various installation methods and configuration options.

Support and Feature Discussions

Due to ongoing challenges with poor quality, AI written Issues and Pull Requests, with little to no human insight or understanding, I've decided to restrict those to collaborators only for now. If you are seeking help or have a feature request or suggestion, please use the appropriate discussion group.

IMPORTANT NOTE - Please read

Ring devices are sold as cloud based devices and this project uses the same cloud based API used by the Ring apps, it does not enable local control of Ring devices as there is no known facility to do so. While using this project does not technically require a Ring Protect subscription, many capabilities are not possible without a subscription and this project is not intended as a way to bypass this requirement. If you don't like cloud powered devices my suggestion is to not purchase them.

Categories

Download Statistics

4,920,950
Total Downloads
90,575
This Month
103,618
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Links

Details

Repository
tsightler/ring-mqtt
Last Updated2026-03-09
First Seen2021-09-05

Runtime arguments

Network
bridge
Privileged
false
Extra Params
--restart unless-stopped

Template configuration

DataPathPathrw

Data Path

Target
/data
Default
/mnt/user/appdata/ring-mqtt
Value
/mnt/user/appdata/ring-mqtt
RINGTOKENVariable

Container Variable: RINGTOKEN

MQTTHOSTVariable

Container Variable: MQTTHOST

MQTTPORTVariable

Container Variable: MQTTPORT

Default
1883
Value
1883
MQTTUSERVariable

Container Variable: MQTTUSER

MQTTPASSWORDVariable

Container Variable: MQTTPASSWORD

ENABLECAMERASVariable

Container Variable: ENABLECAMERAS

Default
false
Value
false
SNAPSHOTMODEVariable

Container Variable: SNAPSHOTMODE

Default
disabled
Value
disabled
ENABLEMODESVariable

Container Variable: ENABLEMODES

Default
false
Value
false
ENABLEPANICVariable

Container Variable: ENABLEPANIC

Default
false
Value
false
BEAMDURATIONVariable

Container Variable: BEAMDURATION

Default
0
Value
0
DISARMCODEVariable

Container Variable: DISARMCODE

RINGLOCATIONIDSVariable

Container Variable: RINGLOCATIONIDS